csi - Man Page
The CHICKEN Scheme interpreter
Synopsis
csi | [OPTION ...] [FILENAME ...] |
Description
csi is an interpreter for the programming language Scheme supporting most of the features as described in the Revised^5 Report on the Algorithmic Language Scheme. csi is implemented as a program compiled with the CHICKEN compiler.
FILENAME is a Scheme source file name with optional extension. OPTION may be one of the following:
- -h, -help
Display usage and exit.
- -version
Display version and exit.
- -release
Print release number and exit.
- -i, -case-insensitive
Enable case-insensitive reading.
- -e EXPRESSION, -eval EXPRESSION
Evaluate the given expression.
- -p EXPRESSION, -print EXPRESSION
Evaluate and print the result(s) of the given expression.
- -P EXPRESSION, -pretty-print EXPRESSION
Evaluate and print result(s) prettily.
- -D SYMBOL, -feature SYMBOL
Register feature identifier.
- -no-feature SYMBOL
Disable built-in feature identifier.
- -q, -quiet
Do not print banner.
- -n, -no-init
Do not load initialization file. ‘.csirc’
- -b, -batch
Terminate after command-line processing.
- -w, -no-warnings
Disable all warnings.
- -K STYLE, -keyword-style STYLE
Enable alternative keyword-syntax (prefix, suffix or none)
- -no-parentheses-synonyms
Disable list delimiter synonyms.
- -no-symbol-escape
Disables support for escaped symbols.
- -r5rs-syntax
Disable the CHICKEN extensions to R5RS syntax.
- -s PATHNAME, -script PATHNAME
Use interpreter for shell scripts.
- -ss PATHNAME
Run a script with a ‘main’ procedure
- -sx PATHNAME
Same as -s, but print each expression as it is evaluated.
- -setup-mode
Prefer the current directory when locating extensions.
- -R NAME, -require-extension NAME
Import extension before executing code.
- -I PATHNAME, -include-path PATHNAME
Add PATHNAME to the include path.
- --
Ignore all following options.
Environment
The following environment variables change the behaviour of csi:
- CSI_OPTIONS
When set to a string of command-line options, then the options are passed implicitly to every direct or indirect invocation of csi. Note that runtime options of the form ‘-:⟨OPTIONS⟩’ cannot be passed using this method.
- CHICKEN_INCLUDE_PATH
Contains one or more pathnames where the interpreter should also look for include files, separated by ‘;’ characters.
Files
- $XDG_CONFIG_HOME/chicken/csirc
Scheme file loaded on startup. (
$XDG_CONFIG_HOME
defaults to$HOME/.config
)- $HOME/.csirc
Scheme file loaded on startup if the previous one doesn’t exists.
Exit Status
The csi utility exits 0 on success, and >0 if an error occurs.
See Also
More information can be found in the CHICKEN User's Manual.
Authors
The CHICKEN Team
Bugs
Submit bug reports by e-mail to chicken-janitors@nongnu.org