summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/fun.texi20
-rw-r--r--doc/img/eval-error.pngbin0 -> 23930 bytes
-rw-r--r--doc/img/geiser-mode.pngbin38574 -> 62445 bytes
3 files changed, 14 insertions, 6 deletions
diff --git a/doc/fun.texi b/doc/fun.texi
index e56af68..b2a0e5f 100644
--- a/doc/fun.texi
+++ b/doc/fun.texi
@@ -340,7 +340,10 @@ region. Again, there's an @i{and go} version available,
For all the commands above, the result of the evaluation is displayed in
the minibuffer, unless it causes a (scheme-side) error, in which case
Geiser will report the problem by opening a debug buffer with
-information on what went wrong.
+information on what went wrong (Racket) or jump into the debugger when
+the REPL provides such a beast (Guile).
+
+@image{img/eval-error}
At the risk of repeating myself, i'll remember you that all these
evaluations will take place in the namespace of the module corresponding
@@ -357,18 +360,23 @@ buffer.
When an error occurs during evaluation, you'll be presented with a
backtrace, in a new buffer where file paths locating the origin of the
-error are clickable (you can navigate them using the @key{TAB} key).
+error are clickable (you can navigate them using the @key{TAB} key, and
+use @key{RET} or the mouse to jump to the offending spot).
@node Jumping around, Geiser writes for you, Evaluating Scheme code, Fun between the parens
@section Jumping around
-This one feature is as sweet as easy to explain: @kbd{M-.} will open the
-file where the identifier around point is defined and land your point on
-its definition. To return to where you were, press @kbd{M-,}.
+This one feature is as sweet as easy to explain: @kbd{M-.}
+(@code{geiser-edit-symbol-at-point}) will open the file where the
+identifier around point is defined and land your point on its
+definition. To return to where you were, press @kbd{M-,}
+(@code{geiser-pop-symbol-stack})..
Sometimes, the underlying Scheme will tell Geiser only the file where
the symbol is defined, but Geiser will use some heuristics (read,
-regular expressions) to locate the exact line and bring you there.
+regular expressions) to locate the exact line and bring you there. Thus,
+if you find Geiser systematically missing your definitions, send a
+message to the mailing list and we'll try to make the algorithm smarter.
You can control how the destination buffer pops up by setting
@code{geiser-edit-symbol-method} to either @code{nil} (to open the file
diff --git a/doc/img/eval-error.png b/doc/img/eval-error.png
new file mode 100644
index 0000000..fb57912
--- /dev/null
+++ b/doc/img/eval-error.png
Binary files differ
diff --git a/doc/img/geiser-mode.png b/doc/img/geiser-mode.png
index 1322a6d..6e6e564 100644
--- a/doc/img/geiser-mode.png
+++ b/doc/img/geiser-mode.png
Binary files differ