source: project/chicken/trunk/csi.1 @ 6226

Last change on this file since 6226 was 6226, checked in by felix winkelmann, 12 years ago

added chicken-bug(1) tool (incomplete, yet); install-info with --info-file=... does not seem to work?

File size: 3.5 KB
Line 
1.\" dummy line
2.TH CSI 1 "10 May 2001"
3
4.SH NAME
5
6The
7.I Chicken
8Scheme interpreter
9
10.SH SYNOPSIS
11
12.B csi
13[
14.I pathname
15|
16.I option ...
17]
18
19.SH DESCRIPTION
20
21.I csi
22is an interpreter for the programming language
23.I Scheme
24supporting most of the features as described in the
25.I Revised^5 Report on
26.I the Algorithmic Language Scheme
27\.
28.I csi
29is implemented as a program compiled with the
30.B chicken
31compiler.
32
33.SH OPTIONS
34
35.TP
36.B \-\-
37Ignore everything on the command-line following this marker. Runtime options
38.B \-\:...
39are still recognized.
40
41.TP
42.B \-i\ \-case\-insensitive
43Enables the reader to read symbols case-insensitive. The default is to read case-sensitive (in violation of R5RS).
44This option registers the
45.B case\-insensitive
46feature identifier.
47
48.TP
49.B \-b\ \-batch
50Quit the interpreter after processing all command line options.
51
52.TP
53.BI \-e\ \-eval \ expressions
54Evaluate
55.I expressions
56\.
57
58.BI \-D\ \-feature \ symbol
59Registers
60.I symbol
61to be a valid feature identifier for
62.B cond\-expand
63
64.TP
65.B \-h\ \-help
66Write a summary of the available command line options to standard ouput and exit.
67
68.TP
69.BI \-I\ \-include\-path \ pathname
70Specifies an alternative search-path for files included via the
71.B include
72special form. This option may be given multiple times. If the environment variable
73.B CHICKEN_INCLUDE_PATH
74is set, it should contain a list of alternative include
75pathnames separated by
76.B \; .
77The environment variable
78.B CHICKEN_HOME
79is also considered as a search path.
80
81.TP
82.BI \-k\ \-keyword\-style style
83Enables alternative keyword syntax, where style may be either
84.B prefix
85(as in Common Lisp),
86.B suffix
87(as in DSSSL) or
88.B none
89Any other value is ignored. The default is \texttt{suffix}.
90
91.TP
92.B \-n\ \-no\-init
93Do not load the initialization-file
94.I ~/\.csirc
95\.
96If this option is not given and the file
97.I ~/\.csirc
98exists, then it is loaded before the read-eval-print loop commences.
99
100.TP
101.B \-w\ \-no\-warnings
102Disables any warnings that might be issued by the reader or evaluated code.
103
104.TP
105.B \-q\ \-quiet
106Do not print a startup message.
107
108.TP
109.BI \-s\ \-script\  pathname
110This is equivalent to
111.B \-batch\ \-quiet
112.I pathname
113, but also ignores all arguments after the argument following
114.B \-script
115
116.TP
117.BI \-ss\ pathname
118Similar to
119.B \-script
120but invokes the procedure
121.B main
122after loading the file specified by
123.B pathname
124with a single argument (the list of command line arguments) returning any result as status code.
125
126.TP
127.BI \-R\ \-require\-extension\  name
128Require extension for evaluated code.
129
130.TP
131.B \-v\ \-version
132Write the banner with version information to standard output and exit.
133
134.SH ENVIRONMENT\ VARIABLES
135
136.TP
137.B CHICKEN_INCLUDE_PATH
138Contains one or more pathnames where the interpreter should also look for include-files, separated by
139.B \;
140characters.
141
142.TP
143.B CHICKEN_HOME
144Should contain the pathname of a directory where interpreter
145support-files can be found. This path is also added to the list of
146pathnames where include-filesd are searched.
147
148.TP
149.B CSI_OPTIONS
150When set to a string of command-line options, then the options are passed implicitly
151to every direct or indirect invocation of
152.I csi
153.br
154Note that runtime options of the form
155.B \-\:\.\.\.
156can not be passed using this method.
157
158.SH DOCUMENTATION
159
160More information can be found in the
161.I Chicken\ User's\ Manual
162
163.SH BUGS
164Submit bug reports by e-mail to
165.I felix@call-with-current-continuation.org
166, preferrably using the
167.B chicken\-bug
168tool.
169
170.SH AUTHOR
171.I csi
172was implemented by Felix Winkelmann (felix@call-with-current-continuation.org).
173
174.SH SEE ALSO
175.BR chicken(1)
176.BR chicken-bug(1)
Note: See TracBrowser for help on using the repository browser.