File: csi.1

package info (click to toggle)
chicken 4.5.0-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 23,272 kB
  • ctags: 36,747
  • sloc: ansic: 373,580; lisp: 57,725; sh: 206; asm: 149; makefile: 110
file content (188 lines) | stat: -rw-r--r-- 3,687 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
-.\" dummy line
.TH CSI 1 "20 May 2008"

.SH NAME

csi \- The Chicken Scheme Interpreter

.SH SYNOPSIS

.B csi
[
.I pathname
|
.I option ...
]

.SH DESCRIPTION

.I csi
is an interpreter for the programming language
.I Scheme
supporting most of the features as described in the
.I Revised^5 Report on
.I the Algorithmic Language Scheme
\.
.I csi
is implemented as a program compiled with the
.B chicken
compiler.

.SH OPTIONS

.TP
.B \-\-
Ignore everything on the command-line following this marker. Runtime options
.B \-\:...
are still recognized.

.TP
.B \-i\ \-case\-insensitive
Enables the reader to read symbols case-insensitive. The default is to read case-sensitive (in violation of R5RS).
This option registers the 
.B case\-insensitive
feature identifier.

.TP
.B \-b\ \-batch
Quit the interpreter after processing all command line options.

.TP
.BI \-e\ \-eval \ expressions
Evaluate
.I expressions
\.

.TP
.BI \-p\ \-print \ expressions
Evaluate 
.I expressions
and print result(s)
\.

.TP
.BI \-P\ \-pretty-print \ expressions
Evaluate 
.I expressions
and pretty-print result(s)
\.

.BI \-D\ \-feature \ symbol
Registers
.I symbol
to be a valid feature identifier for
.B cond\-expand

.TP
.B \-h\ \-help
Write a summary of the available command line options to standard ouput and exit.

.TP
.BI \-I\ \-include\-path \ pathname
Specifies an alternative search-path for files included via the
.B include
special form. This option may be given multiple times. If the environment variable
.B CHICKEN_INCLUDE_PATH
is set, it should contain a list of alternative include
pathnames separated by
.B \; .

.TP
.BI \-k\ \-keyword\-style style
Enables alternative keyword syntax, where style may be either
.B prefix
(as in Common Lisp), 
.B suffix
(as in DSSSL) or
.B none
Any other value is ignored. The default is \texttt{suffix}.

.TP
.B \-n\ \-no\-init
Do not load the initialization-file
.I ~/\.csirc 
\.
If this option is not given and the file
.I ~/\.csirc
exists, then it is loaded before the read-eval-print loop commences. 

.TP
.B \-w\ \-no\-warnings
Disables any warnings that might be issued by the reader or evaluated code.

.TP
.B \-q\ \-quiet
Do not print a startup message.

.TP
.BI \-s\ \-script\  pathname
This is equivalent to
.B \-batch\ \-quiet
.I pathname
, but also ignores all arguments after the argument following
.B \-script

.TP
.BI \-sx\ pathname
Similar to
.B \-script
but invokes prints each expression before it is evaluated,

.TP
.BI \-ss\ pathname
Similar to
.B \-script
but invokes the procedure
.B main
after loading the file specified by
.B pathname
with a single argument (the list of command line arguments) returning any result as status code.

.TP
.BI \-R\ \-require\-extension\  name
Require extension for evaluated code.

.TP 
.B \-v\ \-version
Write the banner with version information to standard output and exit.

.SH ENVIRONMENT\ VARIABLES

.TP
.B CHICKEN_INCLUDE_PATH
Contains one or more pathnames where the interpreter should also look for include-files, separated by 
.B \;
characters.

.TP
.B CHICKEN_PREFIX
Is used as a prefix directory for support files, include-files and libraries.

.TP
.B CSI_OPTIONS
When set to a string of command-line options, then the options are passed implicitly
to every direct or indirect invocation of
.I csi
.br
Note that runtime options of the form
.B \-\:\.\.\.
can not be passed using this method.

.SH DOCUMENTATION

More information can be found in the
.I Chicken\ User's\ Manual

.SH BUGS
Submit bug reports by e-mail to
.I chicken-janitors@nongnu.org
, preferrably using the
.B chicken\-bug
tool.

.SH AUTHOR
Felix Winkelmann and the Chicken Team

.SH SEE ALSO
.BR chicken(1)
.BR chicken-bug(1)