DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

(guile.info.gz) Invoking Guile

Info Catalog (guile.info.gz) Guile Scripting (guile.info.gz) The Meta Switch
 
 9.1 Invoking Guile
 ==================
 
 Here we describe Guile's command-line processing in detail.  Guile
 processes its arguments from left to right, recognizing the switches
 described below.  For examples, see  Scripting Examples.
 
 `-s SCRIPT ARG...'
      Read and evaluate Scheme source code from the file SCRIPT, as the
      `load' function would.  After loading SCRIPT, exit.  Any
      command-line arguments ARG... following SCRIPT become the script's
      arguments; the `command-line' function returns a list of strings
      of the form `(SCRIPT ARG...)'.
 
 `-c EXPR ARG...'
      Evaluate EXPR as Scheme code, and then exit.  Any command-line
      arguments ARG... following EXPR become command-line arguments; the
      `command-line' function returns a list of strings of the form
      `(GUILE ARG...)', where GUILE is the path of the Guile executable.
 
 `-- ARG...'
      Run interactively, prompting the user for expressions and
      evaluating them.  Any command-line arguments ARG... following the
      `--' become command-line arguments for the interactive session; the
      `command-line' function returns a list of strings of the form
      `(GUILE ARG...)', where GUILE is the path of the Guile executable.
 
 `-l FILE'
      Load Scheme source code from FILE, and continue processing the
      command line.
 
 `-e FUNCTION'
      Make FUNCTION the "entry point" of the script.  After loading the
      script file (with `-s') or evaluating the expression (with `-c'),
      apply FUNCTION to a list containing the program name and the
      command-line arguments -- the list provided by the `command-line'
      function.
 
      A `-e' switch can appear anywhere in the argument list, but Guile
      always invokes the FUNCTION as the _last_ action it performs.
      This is weird, but because of the way script invocation works under
      POSIX, the `-s' option must always come last in the list.
 
       Scripting Examples.
 
 `-ds'
      Treat a final `-s' option as if it occurred at this point in the
      command line; load the script here.
 
      This switch is necessary because, although the POSIX script
      invocation mechanism effectively requires the `-s' option to
      appear last, the programmer may well want to run the script before
      other actions requested on the command line.  For examples, see
       Scripting Examples.
 
 `\'
      Read more command-line arguments, starting from the second line of
      the script file.   The Meta Switch.
 
 `--emacs'
      Assume Guile is running as an inferior process of Emacs, and use a
      special protocol to communicate with Emacs's Guile interaction
      mode.  This switch sets the global variable use-emacs-interface to
      `#t'.
 
      This switch is still experimental.
 
 `--use-srfi=LIST'
      The option `--use-srfi' expects a comma-separated list of numbers,
      each representing a SRFI number to be loaded into the interpreter
      before starting evaluating a script file or the REPL.
      Additionally, the feature identifier for the loaded SRFIs is
      recognized by `cond-expand' when using this option.
 
           guile --use-srfi=8,13
 
 `--debug'
      Start with the debugging evaluator and enable backtraces.  Using
      the debugging evaluator will give you better error messages but it
      will slow down execution.  By default, the debugging evaluator is
      only used when entering an interactive session.  When executing a
      script with `-s' or `-c', the normal, faster evaluator is used by
      default.
 
 `-h, --help'
      Display help on invoking Guile, and then exit.
 
 `-v, --version'
      Display the current version of Guile, and then exit.
 
 
Info Catalog (guile.info.gz) Guile Scripting (guile.info.gz) The Meta Switch
automatically generated byinfo2html