diff options
author | jao <jao@gnu.org> | 2021-12-05 20:10:21 +0000 |
---|---|---|
committer | jao <jao@gnu.org> | 2021-12-05 20:10:21 +0000 |
commit | a998dd8a81dbecb5cbb285d99afe749307f604be (patch) | |
tree | 3907d02cfb64897892ce34fda9f795f8b1ff6d30 | |
parent | b4bd69d8c3d6dcc8b508579054eb7905923ef738 (diff) | |
download | geiser-a998dd8a81dbecb5cbb285d99afe749307f604be.tar.gz geiser-a998dd8a81dbecb5cbb285d99afe749307f604be.tar.bz2 |
Documentation bits
Starting to move Guile-specific stuff to geiser-guile's
readme.org (from which we'll generate an info file, fear not).
-rw-r--r-- | doc/repl.texi | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/doc/repl.texi b/doc/repl.texi index 2209ad0..4f28d82 100644 --- a/doc/repl.texi +++ b/doc/repl.texi @@ -431,22 +431,22 @@ configuration. @cindex scheme init file @cindex GUILE_LOAD_PATH @cindex GUILE_LOAD_COMPILED_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 (and its compiled load path) when it's started, while -@code{geiser-guile-init-file} is the path to an initialisation file to -be loaded on start-up. The equivalent variables for Racket are -@code{geiser-racket-collects} and @code{geiser-racket-init-file}. - -Note, however, that specifying @code{geiser-guile-init-file} is @i{not} -equivalent to changing Guile's initialization file (@file{~/.guile}), -because the former is loaded using the @code{-l} flag, together with -@code{-q} to disable loading the second. But there are subtle -differences in the way Guile loads the initialization file versus how it -loads a file specified via the @code{-l} flag. If what you want is just -loading @file{~/.guile}, leave @code{geiser-guile-init-file} alone and -set @code{geiser-guile-load-init-file-p} to @code{t} instead. +@cindex geiser-add-to-load-path +@cindex geiser-repl-add-project-paths +@subsubheading Init files and load paths +The startup behaviour of the REPL can be also fine tuned with a couple +more initialisation parameters. + +Many Scheme implementations provide a configuration variable to specify +a Geiser-specific init file (e.g., @code{geiser-guile-init-file} for +Guile), and, sometimes a global list of paths to add to the +interpreter's load path (that'd be @code{geiser-guile-load-path} for +Guile). + +There is also a generic mechanism to specify how to add directories to +the initial load path when @code{geiser-repl-current-project-function} +is set: you can then customize @code{geiser-repl-add-project-paths} to a +list of subdirectories of the project's root to add to the load path. These variables controlling your scheme's initialisation process are good candidates for an entry in a project's @file{.dir-locals.el} file, |