diff options
Diffstat (limited to 'doc/parens.texi')
| -rw-r--r-- | doc/parens.texi | 52 |
1 files changed, 40 insertions, 12 deletions
diff --git a/doc/parens.texi b/doc/parens.texi index 65e6554..374444f 100644 --- a/doc/parens.texi +++ b/doc/parens.texi @@ -6,8 +6,14 @@ hacking environment. Well, perhaps a bit more than a half; but, at any rate, one surely needs also a pleasant way of editing source code. Don't pay attention to naysayers: Emacs comes with an excellent editor included for about any language on Earth, and just the best one when -that language is sexpy (especially if you use @alt{@ref{paredit,,Paredit}).,Paredit).} -Geiser's support for writing Scheme code adds to Emacs' +that language is sexpy (especially if you use +@ifhtml +@ref{paredit,,Paredit}). +@end ifhtml +@ifnothtml +Paredit). +@end ifnothtml + Geiser's support for writing Scheme code adds to Emacs' @code{scheme-mode}, rather than supplanting it; and it does so by means of a minor mode (unimaginatively dubbed @code{geiser-mode}) that defines a bunch of new commands to try and, with the help of the same Scheme @@ -52,8 +58,13 @@ tried to make Geiser as self-documenting as any self-respecting Emacs package should be. If you follow this route, make sure to take a look at Geiser's customization buffers (@kbd{M-x customize-group @key{RET} geiser}): there's lot of fine-tuning available there. You might also -want to take a glance at @alt{@ref{Cheat sheet}., the tables in -@pxref{Cheat sheet, the cheat sheet}.} +want to take a glance at +@ifhtml +our @ref{Cheat sheet,,cheat sheet}. +@end ifhtml +@ifnothtml +the tables in @pxref{Cheat sheet, our cheat sheet}. +@end ifnothtml Since @i{geiser-mode} is a minor mode, you can toggle it with @kbd{M-x geiser-mode}, and control its activation in hooks with the @@ -82,9 +93,14 @@ how to make sure that that's actually the case. As i've already mentioned a couple of times, @i{geiser-mode} needs a running REPL to be operative. Thus, a common usage pattern will be -for you to first call @code{run-geiser} or one of its variants -(@pxref{choosing-impl,choosing implementations}), and then open -some Scheme files; +for you to first call @code{run-geiser} +@ifhtml +(or @ref{choosing-impl,,one of its variants}), +@end ifhtml +@ifnothtml +(or one of its variants, e.g. @code{run-guile}), +@end ifnothtml +and then open some Scheme files; but there's nothing wrong in first opening a couple Scheme buffers and then starting the REPL (you can even find it more convenient, since pressing @kbd{C-c C-z} in a Scheme buffer will start the REPL for @@ -117,8 +133,14 @@ surrounded by @code{-*-} marks, as in: @item If you've customized @code{geiser-active-implementations} so that it's a -single-element list (as explained @ref{choosing-impl,,here}), that -element is used as the chosen implementation. +single-element +@ifnotinfo +list (as explained in @ref{choosing-impl,,here}), +@end ifnotinfo +@ifinfo +list, +@end ifinfo +that element is used as the chosen implementation. @item The contents of the file is scanned for hints on its associated implementation. For instance, files that contain a @code{#lang} @@ -188,7 +210,7 @@ If you use a numeric prefix, as in @kbd{C-u C-c C-z}, besides being teleported to the REPL, the latter will switch to the namespace of the Scheme source file (as if you had used @kbd{C-c C-m} in the REPL, with the source file's module as argument; cf. discussion in -@altr{Switching context,,Switching context,)}. This command is also +@altr{Switching context,,Switching context,).}This command is also bound to @kbd{C-c C-Z}, with a capital zed. Once you're in the REPL, the same @kbd{C-c C-z} shortcut will bring @@ -200,8 +222,14 @@ really handy, if you ask me. @cindex switching schemes If for some reason you're not happy with the Scheme implementation that Geiser has assigned to your file, you can change it with @kbd{C-c C-s}, -and you probably should take a look at @alt{@ref{repl-association,,the -previous subsection}, the previous subsection} to make sure that Geiser +and you probably should take a look at +@ifhtml +@ref{repl-association,,the previous subsection} +@end ifhtml +@ifnothtml +the previous subsection +@end ifnothtml +to make sure that Geiser doesn't get confused again. @subsubheading A note about context |