Completion: a bit of documentation

2 files changed, 17 insertions, 6 deletions

diff --git a/doc/parens.texi b/doc/parens.texi
index a902b27..c65522b 100644
--- a/doc/parens.texi
+++ b/doc/parens.texi
@@ -480,6 +480,16 @@ you're at the end of the following partial expression:
 and press @kbd{M-@key{TAB}}, one of the possible completions will be
 @code{default}.
 
+@cindex partial completion
+After obtaining the list of completions from the running Scheme, Geiser
+uses the standard Emacs completion machinery to display them. That
+means, among other things, that partial completion is available: just
+try to complete @code{d-s} or @code{w-o-t-s} to see why this is a good
+thing. Partial completion won't work if you have disabled it globally in
+your Emacs configuration: if you don't know what i'm talking about,
+never mind: Geiser's partial completion will work for you out of the
+box.
+
 @cindex smart tabs
 If you find the @kbd{M} modifier annoying, you always have the option to
 activate @code{geiser-smart-tab-mode}, which will make the @key{TAB} key
@@ -495,11 +505,12 @@ try to find a module name that matches it. You can also request
 explicitly completion only over module names using @kbd{M-`} (that's a
 backtick).
 
-There's also this little command, @code{geiser-squarify}, which will
-toggle the delimiters of the innermost list around point between round
-and square brackets. It is bound to @kbd{C-c C-e [}. With a numeric
-prefix (as in, say, @kbd{M-2 C-c C-e [}), it will perform that many
-toggles, forward for positive values and backward for negative ones.
+Besides completion, there's also this little command,
+@code{geiser-squarify}, which will toggle the delimiters of the
+innermost list around point between round and square brackets. It is
+bound to @kbd{C-c C-e [}. With a numeric prefix (as in, say, @kbd{M-2
+C-c C-e [}), it will perform that many toggles, forward for positive
+values and backward for negative ones.
 
 @c Local Variables:
 @c mode: texinfo
diff --git a/doc/repl.texi b/doc/repl.texi
index a87c547..cfce6c8 100644
--- a/doc/repl.texi
+++ b/doc/repl.texi
@@ -161,7 +161,7 @@ Which brings me to the next group of REPL commands.
 @node Completion and error handling, Autodoc and friends, Switching context, The REPL
 @section Completion and error handling
 
-@cindex completion, module name
+@cindex completion, at the REPL
 We've already seen Geiser completion of module names in action at the
 mini-buffer. You won't be surprised to know that it's also available at
 the REPL buffer itself. There, you can use either @kbd{C-.} or