summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJose Antonio Ortega Ruiz <jao@gnu.org>2010-09-04 21:17:12 +0200
committerJose Antonio Ortega Ruiz <jao@gnu.org>2010-09-04 21:17:12 +0200
commit8c71db0234142c3b45352773ab98e68b0bc7ad11 (patch)
treef6fe5ed2fb54d37cb3d4ff53b152859a1b43e3e5 /doc
parent04420adfbae0e37207700ebe0aca01f92012adcf (diff)
downloadgeiser-8c71db0234142c3b45352773ab98e68b0bc7ad11.tar.gz
geiser-8c71db0234142c3b45352773ab98e68b0bc7ad11.tar.bz2
REPL: (optionally) forget old errors on new expressions
Diffstat (limited to 'doc')
-rw-r--r--doc/geiser.texi16
-rw-r--r--doc/repl.texi27
2 files changed, 25 insertions, 18 deletions
diff --git a/doc/geiser.texi b/doc/geiser.texi
index afd71e9..61e99fb 100644
--- a/doc/geiser.texi
+++ b/doc/geiser.texi
@@ -46,6 +46,8 @@ The document was typeset with
@node Top, Introduction, (dir), (dir)
@top Geiser
+@include top.texi
+
@menu
* Introduction::
* Installation::
@@ -81,7 +83,8 @@ The REPL
* Starting the REPL::
* First aids::
* Switching context::
-* Let Geiser spy::
+* Completion and error handling::
+* Autodoc and friends::
* Customization and tips::
Fun between the parens
@@ -96,19 +99,8 @@ Fun between the parens
@end detailmenu
@end menu
-@include top.texi
-
@insertcopying
-@menu
-* Introduction::
-* Installation::
-* The REPL::
-* Fun between the parens::
-* Index::
-
-@end menu
-
@end ifnottex
@include intro.texi
diff --git a/doc/repl.texi b/doc/repl.texi
index d8583df..b314172 100644
--- a/doc/repl.texi
+++ b/doc/repl.texi
@@ -9,7 +9,8 @@ ready, just come back here and proceed to the following sections.
* Starting the REPL::
* First aids::
* Switching context::
-* Let Geiser spy::
+* Completion and error handling::
+* Autodoc and friends::
* Customization and tips::
@end menu
@@ -85,7 +86,7 @@ as explained @ref{switching-repl-buff,,here}).
The remaining commands are meatier, and deserve sections of their own.
-@node Switching context, Let Geiser spy, First aids, The REPL
+@node Switching context, Completion and error handling, First aids, The REPL
@section Switching context
@cindex current module, in REPL
@@ -118,8 +119,8 @@ a prefix-aware list of available module names.
Which brings me to the next group of @repl{} commands.
-@node Let Geiser spy, Customization and tips, Switching context, The REPL
-@section Let Geiser spy, write and jump for you
+@node Completion and error handling, Autodoc and friends, Switching context, The REPL
+@section Completion and error handling
@cindex completion, module name
We've already seen Geiser completion of module names in action at the
@@ -132,7 +133,19 @@ starting with the prefix at point. Needless to say, this is not a static
list, and it will grow as you define or import new bindings in the
namespace at hand.
-But, oftentimes, there's more you'll want to know about an identifier
+REPL buffers use Emacs' compilation mode to highlight errors reported by
+the Scheme interpreter, and you can use the @command{next-error} command
+(@kbd{M-g n}) to jump to their location. By default, every time you
+enter a new expression for evaluation old error messages are forgotten,
+so that @kbd{M-g n} will always jump to errors related to the last
+evaluation request, if any. If you prefer a not so forgetful REPL, set
+the customization variable @code{geiser-repl-forget-old-errors-p} to
+@code{nil}.
+
+@node Autodoc and friends, Customization and tips, Completion and error handling, The REPL
+@section Autodoc and friends
+
+Oftentimes, there's more you'll want to know about an identifier
besides its name: what module does it belong to? is it a procedure and,
if so, what arguments does it take? Geiser tries to help you answering
those questions too.
@@ -187,7 +200,7 @@ sections (but just perusing it's associated key bindings, by any of the
methods we've already used for the @repl{}, will give you enough
information to use it effectively enough).
-@node Customization and tips, , Let Geiser spy, The REPL
+@node Customization and tips, , Autodoc and friends, The REPL
@section Customization and tips
@cindex REPL customization
@@ -227,6 +240,8 @@ full path to the requisite binary.
@cindex scheme load path
@cindex scheme init file
+@cindex GUILE_LOAD_PATH
+@cindex PLTCOLLECTS
You can also specify a couple more initialisation parameters. For Guile,
@code{geiser-guile-load-path} is a list of paths to add to its load path
when it's started, while @code{geiser-guile-init-file} is the path to an