mu4e/man/mu-scm.1.org

MU SCM

• NAME
• SYNOPSIS
• DESCRIPTION
• SCM OPTIONS
  • –listen
  • –eval
• ENVIRONMENT
• SEE ALSO

NAME

mu-scm - bindings and shell for the GNU Guile programming language.

SYNOPSIS

mu scm [​_COMMON-OPTIONS_​]

starts the GNU Guile shell.

mu scm [​_COMMON-OPTIONS_​] ​_COMMAND_​] -- [​_COMMAND-OPTIONS_​

runs a GNU Guile script.

DESCRIPTION

mu scm is the command to use the bindings to the GNU Guile programming language. It can either open a shell ("REPL") or run scripts.

Using mu scm, you can script mu.

SCM OPTIONS

–listen

With the --listen parameter, mu scm starts listening on a UNIX domain socket. This can be used for communicating with the REPL using some external tool, such as Emacs with the "Geiser" package. For details, refer to the mu-scm Info manual.

It blocks after printing the name of the socket (which is a randomized name), prefixed by UNIX_CONNECT: and ending with a newline. For instance:

UNIX-CONNECT:/run/user/1000/mu-scm-socket-4eb5db40

–eval

With the --eval option you can evaluate an expression in mu/scm environment. For example:

$ mu scm --eval '(format #t "found ~d match(es)\n" (length (mfind "hello")))'
found 7173 match(es)

ENVIRONMENT

By default, mu scm expects its internal files to be found in <prefix>/share/mu/scm. However, for development/testing you can set the environment variable MU_SCM_DIR to some alternative directory.

SEE ALSO

The full documentation for mu scm is maintained as a Texinfo manual. If the info and mu programs are properly installed at your site, the command info mu-scm should give you access to the complete manual.

http://www.schemers.org provides a general introduction to the Scheme language.