~ chicken-core (chicken-5) /csi.mdoc

  1.\"  Copyright (c) 2007-2022, The CHICKEN Team
  2.\"  All rights reserved.
  3.\"
  4.\"  Redistribution and use in source and binary forms, with or without
  5.\"  modification, are permitted provided that the following conditions
  6.\"  are met:
  7.\"  1. Redistributions of source code must retain the above copyright
  8.\"     notice, this list of conditions and the following disclaimer.
  9.\"  2. Redistributions in binary form must reproduce the above copyright
 10.\"     notice, this list of conditions and the following disclaimer in the
 11.\"     documentation and/or other materials provided with the distribution.
 12.\"  3. The name of the authors may not be used to endorse or promote products
 13.\"     derived from this software without specific prior written permission.
 14.\"
 15.\"  THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
 16.\"  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 17.\"  OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 18.\"  IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 19.\"  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 20.\"  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 21.\"  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 22.\"  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 23.\"  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 24.\"  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 25.\"
 26.\"
 27.Dd Apr 26, 2017
 28.Dt CSI 1
 29.Os
 30.Sh NAME
 31.Nm csi
 32.Nd The CHICKEN Scheme interpreter
 33.Sh SYNOPSIS
 34.Nm
 35.Op Ar OPTION  ...
 36.Op Ar FILENAME ...
 37.Sh DESCRIPTION
 38.Nm
 39is an interpreter for the programming language Scheme supporting most of
 40the features as described in the Revised^5 Report on the Algorithmic
 41Language Scheme.
 42.Nm
 43is implemented as a program compiled with the CHICKEN compiler.
 44.Pp
 45.Ar FILENAME
 46is a Scheme source file name with optional extension.
 47.Ar OPTION
 48may be  one of the following:
 49.Bl -tag -width Ds
 50.It Fl h , Fl help
 51Display usage and exit.
 52.It Fl version
 53Display version and exit.
 54.It Fl release
 55Print release number and exit.
 56.It Fl i , Fl case-insensitive
 57Enable case-insensitive reading.
 58.It Fl e Ar EXPRESSION , Fl eval Ar EXPRESSION
 59Evaluate the given expression.
 60.It Fl p Ar EXPRESSION , Fl print Ar EXPRESSION
 61Evaluate and print the result(s) of the given expression.
 62.It Fl P Ar EXPRESSION , Fl pretty-print Ar EXPRESSION
 63Evaluate and print result(s) prettily.
 64.It Fl D Ar SYMBOL , Fl feature Ar SYMBOL
 65Register feature identifier.
 66.It Fl no-feature Ar SYMBOL
 67Disable built-in feature identifier.
 68.It Fl q , Fl quiet
 69Do not print banner.
 70.It Fl n , Fl no-init
 71Do not load initialization file.
 72.Sq .csirc
 73.It Fl b , Fl batch
 74Terminate after command-line processing.
 75.It Fl w , Fl no-warnings
 76Disable all warnings.
 77.It Fl K Ar STYLE , Fl keyword-style Ar STYLE
 78Enable alternative keyword-syntax
 79.Po prefix, suffix or none Pc
 80.It Fl no-parentheses-synonyms
 81Disable list delimiter synonyms.
 82.It Fl no-symbol-escape
 83Disables support for escaped symbols.
 84.It Fl r5rs-syntax
 85Disable the CHICKEN extensions to R5RS syntax.
 86.It Fl s Ar PATHNAME , Fl script Ar PATHNAME
 87Use interpreter for shell scripts.
 88.It Fl ss Ar PATHNAME
 89Run a script with a
 90.Sq main
 91procedure
 92.It Fl sx Ar PATHNAME
 93Same as
 94.Fl s ,
 95but print each expression as it is evaluated.
 96.It Fl setup-mode
 97Prefer the current directory when locating extensions.
 98.It Fl R Ar NAME , Fl require-extension Ar NAME
 99Import extension before executing code.
100.It Fl I Ar PATHNAME , Fl include-path Ar PATHNAME
101Add
102.Ar PATHNAME
103to the include path.
104.It Fl -
105Ignore all following options.
106.El
107.Sh ENVIRONMENT
108The following environment variables change the behaviour of
109.Nm Ns :
110.Bl -tag -width CHICKEN_INCLUDE_PATH
111.It Ev CSI_OPTIONS
112When set to a string of command-line options, then the options are
113passed implicitly to every direct or indirect invocation of
114.Nm . Note that runtime options of the form
115.Sq \&-: Ns Aq OPTIONS
116cannot be passed using this method.
117.It Ev CHICKEN_INCLUDE_PATH
118Contains one or more pathnames where the interpreter should also look
119for include files, separated by
120.Sq \&;
121characters.
122.El
123.Sh FILES
124.Bl -tag -width 4n
125.It Pa $XDG_CONFIG_HOME/chicken/csirc
126Scheme file loaded on startup. (
127.Ev $XDG_CONFIG_HOME
128defaults to
129.Pa $HOME/.config
130)
131.It Pa $HOME/.csirc
132Scheme file loaded on startup if the previous one doesn’t exists.
133.El
134.Sh EXIT STATUS
135.Ex -std
136.Sh SEE ALSO
137.Xr chicken 1 ,
138.Xr csc 1
139.Pp
140More information can be found in the
141.Lk http://wiki.call-cc.org/manual/index "CHICKEN User's Manual".
142.Sh AUTHORS
143.An The CHICKEN Team
144.Sh BUGS
145Submit bug reports by e-mail to
146.Mt chicken-janitors@nongnu.org