readme.org


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

* Guile and Geiser talk to each other

This package provides support for using [[https://www.gnu.org/software/guile/][GNU Guile]] in Emacs with
[[http://geiser.nongnu.org][Geiser]].

Provided [[https://gitlab.com/emacs-geiser/geiser][geiser]] is installed in your system, if this package's
directory is in your load path, just add ~(require 'geiser-guile)~ to
your initialisation files and then ~M-x run-guile~ to start a REPL.
Scheme files with a Guile module declaration should be automatically
recognised as Guile-flavoured Geiser buffers.

The easiest way of installing this package is using NonGNU Elpa or
MELPA.  If you're in Emacs 28 or higher, the former is already enabled
and all you need is the familiar

#+begin_src elisp
  M-x install-package RET geiser-guile RET
#+end_src

That will also install geiser, and its fine info manual.  Please refer
to it (or its [[https://geiser.nongnu.org][online version]]) for a general description of how geiser
schemes work.  We provide below some additional details specific to
geiser-guile.

*** Start up

    When launching the Guile REPL, geiser will invoke the binary
    configured in ~geiser-guile-binary~ (simply "guile" by default)
    which in turn will load ~geiser-guile-init-file~, if any.

    Note, however, that specifying ~geiser-guile-init-file~ is /not/
    equivalent to changing Guile's initialization file (=~/.guile=),
    because the former is loaded using the =-l= flag, together with =-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 =-l= flag.  If what you want is just
    loading =~/.guile=, leave ~geiser-guile-init-file~ alone and set
    ~geiser-guile-load-init-file-p~ to ~t~ instead.

    One can also provide a global list of paths to add to Guile's
    =%load-path= via ~geiser-guile-load-path~.