summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjao <jao@gnu.org>2021-12-05 20:10:21 +0000
committerjao <jao@gnu.org>2021-12-05 20:10:21 +0000
commita998dd8a81dbecb5cbb285d99afe749307f604be (patch)
tree3907d02cfb64897892ce34fda9f795f8b1ff6d30
parentb4bd69d8c3d6dcc8b508579054eb7905923ef738 (diff)
downloadgeiser-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.texi32
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,