From a998dd8a81dbecb5cbb285d99afe749307f604be Mon Sep 17 00:00:00 2001 From: jao Date: Sun, 5 Dec 2021 20:10:21 +0000 Subject: Documentation bits Starting to move Guile-specific stuff to geiser-guile's readme.org (from which we'll generate an info file, fear not). --- doc/repl.texi | 32 ++++++++++++++++---------------- 1 file 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, -- cgit v1.2.3