summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJose Antonio Ortega Ruiz <jao@gnu.org>2010-08-07 02:53:09 +0200
committerJose Antonio Ortega Ruiz <jao@gnu.org>2010-08-07 02:53:09 +0200
commit188031e2c7c2971cb31f319d51b7cd465380f3a4 (patch)
tree5d28d2a1d1087f4d22189f5c9565c48a8ddae8fe /doc
parent7ee06b0911ff7b3fedc0404c22883706a8d128f7 (diff)
downloadgeiser-guile-188031e2c7c2971cb31f319d51b7cd465380f3a4.tar.gz
geiser-guile-188031e2c7c2971cb31f319d51b7cd465380f3a4.tar.bz2
Manual: autodoc description completed.
Diffstat (limited to 'doc')
-rw-r--r--doc/fun.texi34
-rw-r--r--doc/img/autodoc-multi.pngbin0 -> 15893 bytes
-rw-r--r--doc/img/autodoc-var.pngbin0 -> 7931 bytes
3 files changed, 33 insertions, 1 deletions
diff --git a/doc/fun.texi b/doc/fun.texi
index 6a8f745..f839192 100644
--- a/doc/fun.texi
+++ b/doc/fun.texi
@@ -220,7 +220,39 @@ followed by a list of argument names, starting with the ones that are
required. Then there comes a square-bracketed list of optional argument
names, if any. When an optional argument has a default value (or a form
defining its default value), instead of a plain name, autodoc will
-display a list with the name followed by its initialisation form
+display a list with the name followed by its initialisation form. When
+the optional arguments are keywords, their names are prefixed with a
+colon. An ellipsis (@dots{}) servers as a marker of an indeterminated
+number of parameters, as is the case with @i{rest} arguments or when
+autodoc cannot fathom the exact number of arguments (this is often the
+case with macros defined using @code{syntax-case}). Another way in which
+autodoc displays its ignorance is by using and underscore to display
+parameters whose name is beyond its powers.
+
+@img{autodoc-multi, right} It can also be the case that a function or
+macro has more than one signature (e.g., functions defined using
+@code{case-lambda}, or some @code{syntax-rules} macros, for which Geiser
+has often the black magic necessary to retrieve their actual arities).
+In those cases, autodoc shows all known signatures (using the above
+rules for each one) separated by a vertical bar (|). As you have already
+noticed, the whole thing is enclosed in parenthesis. After all, we're
+talking about Scheme here.
+
+@img{autodoc-var, right} Finally, life is much easier when your cursor
+is on a symbol corresponding to a plain variable: you'll see in the echo
+area its name, preceded by the module where it's defined, and followed
+by its value, with an intervening arrow for greater effect. This time,
+there are no enclosing parenthesis (i hope you see the logic in my
+madness).
+
+You can change the way Geiser displays the module/identifier combo by
+customizing @var{geiser-autodoc-identifier-format}. For example, if you
+wanted a tilde surrounded by spaces instead of a colon as a separator,
+you would write something like
+@example
+(setq geiser-autodoc-identifier-format "%s ~ %s")
+@end example
+in your Emacs initialization files.
@node Evaluating Scheme code, Jumping around, Autodoc redux, Fun between the parens
@section Evaluating Scheme code
diff --git a/doc/img/autodoc-multi.png b/doc/img/autodoc-multi.png
new file mode 100644
index 0000000..3d5816d
--- /dev/null
+++ b/doc/img/autodoc-multi.png
Binary files differ
diff --git a/doc/img/autodoc-var.png b/doc/img/autodoc-var.png
new file mode 100644
index 0000000..c1927b4
--- /dev/null
+++ b/doc/img/autodoc-var.png
Binary files differ