![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to spitbol.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / mana|
Return to spitbol.1 CVS log | Up to [Research Unix] / researchv10dc / man / mana |
1.1 root 1: .TH SPITBOL 1
2: .SH NAME
3: spitbol \- Snobol language compiler
4: .SH SYNOPSIS
5: .B spitbol
6: [
7: .I options
8: ]
9: .I ifile ...
10: .SH DESCRIPTION
11: .I Spitbol
12: is an upward compatible
13: dialect of SNOBOL4.
14: .PP
15: All names used in a program are normally mapped to UPPER CASE during
16: compilation and execution.
17: For strict compatibility with SNOBOL4, use the \-f
18: option or \-CASE control statement.
19: .PP
20: Each
21: .IR ifile
22: is read in order before the standard input.
23: Standard output comes only from assignments to OUTPUT and from
24: error messages.
25: .PP
26: Compiler options:
27: .TP "\w'-u string 'u"
28: .B \-f
29: don't fold lower case names to UPPER CASE
30: .TP
31: .B \-e
32: don't send error messages to the terminal
33: .TP
34: .B \-l
35: generate source listing
36: .TP
37: .B \-c
38: generate compilation statistics
39: .TP
40: .B \-x
41: generate execution statistics
42: .TP
43: .B \-a
44: like
45: .B "\-lcx"
46: .TP
47: .B \-p
48: long listing format; generates form feeds
49: .TP
50: .B \-z
51: use standard listing format
52: .TP
53: .B \-h
54: write
55: .I spitbol
56: header to standard output
57: .TP
58: .B \-n
59: suppress execution
60: .TP
61: .BI \-m dd
62: max size (words) of created object
63: (default 8192)
64: .TP
65: .BI \-s dd
66: maximum size (words) of stack space
67: (default 2048)
68: .TP
69: .BI \-i dd
70: size (words) of increment by which dynamic area is increased
71: (default 4096)
72: .TP
73: .BI \-d dd
74: size (words) of maximum allocated dynamic area
75: (default 256K)
76: .TP
77: .BI \-u " string"
78: executing program may retrieve string with HOST(0)
79: .TP
80: .BI \-o " ofile"
81: write listing, statistics and dump to
82: .I ofile
83: and OUTPUT to standard output
84: .PP
85: Note:
86: .I dd
87: can be followed by a
88: .B k
89: to indicate units of 1024.
90: .PP
91: .PP
92: .I Spitbol
93: has two input-output modes,
94: .I line mode,
95: where records are delimited by new-line characters, and
96: .I "raw mode"
97: where a predetermined number of bytes
98: is transferred.
99: Modes are specified in INPUT or OUTPUT function calls.
100: The maximum length of an input record is set by the
101: .B \-l
102: or
103: .B \-r
104: argument.
105: The form of the INPUT/OUTPUT function call is
106: .IP
107: INPUT/OUTPUT(.name,channel,file_name args)
108: .PP
109: where
110: .I name
111: is the variable name to be input/output associated and
112: .I "channel"
113: is an integer or string that identifies the association
114: to be used in subsequent calls for EJECT, ENDFILE,
115: INPUT, OUTPUT, REWIND, and SET.
116: If the
117: .I channel
118: is omitted or the null string, the association is
119: made to the system's standard input or output stream.
120: .I "file_name args"
121: specifies the source/destination of the
122: input/output and any IO processing arguments. The
123: .I file_name
124: can be either a path name to a file or a
125: command string. Command strings are distinguished from
126: file names by a leading "!". The character following the
127: "!" is the delimiter used to separate the command string
128: from any IO processing arguments. The ending delimiter
129: may be omitted if there are no IO processing arguments.
130: There must always be at least one space between the
131: .I file_name
132: and
133: .I args,
134: even if the
135: .I file_name
136: is null.
137: .PP
138: .PP
139: Input/output arguments are:
140: .TP
141: .B \-a
142: Append output to existing file. If file doesn't exist
143: then it is created.
144: If
145: .B \-a
146: is not specified then file
147: is created.
148: .TP
149: .BI \-b dd
150: Set internal buffer size to
151: .I dd
152: characters. This value
153: is the byte count used on all input/output transfers
154: except for the last write to an output file
155: (default 4096).
156: .TP
157: .B \-c
158: Like
159: .BI \-r 1
160: .TP
161: .BI \-f dd
162: Use
163: .I dd
164: as file desciptor for IO.
165: .I spitbol
166: assumes that
167: .I dd
168: has been opened by the shell. File names and
169: .BI \-f dd
170: arguments are mutually exclusive.
171: File descriptors
172: 0, 1, and 2
173: may
174: be accessed in this manner.
175: .TP
176: .BI \-l dd
177: Line mode: maximum input record length is
178: .I dd
179: characters (default 4096).
180: .TP
181: .BI \-r dd
182: Raw mode: input record length is
183: .I dd
184: characters.
185: .TP
186: .B \-w
187: On output, each record is directly written to the
188: file without any intermediate buffering (default for terminals).
189: On input, each input operation uses exactly one
190: .IR read (2),
191: and fails if
192: .I read
193: returns 0.
194: .PP
195: More than one type of transfer may be associated with a channel.
196: This is accomplished by calling INPUT/OUTPUT after the initial
197: call with the name, channel, and file arguments. The
198: file name or
199: .B \-f
200: argument must not be specified on calls subsequent
201: to the first.
202: .PP
203: Standard functions:
204: .RI SET( channel,integer,integer )
205: The arguments are same as those to the
206: .IR lseek (2),
207: escept that
208: the first argument identifies a spitbol channel instead of
209: a file descriptor.
210: .TP
211: EXIT(\fIcommand-string\fP)
212: causes the value of
213: .I command-string
214: to be handed to the Shell to be executed after
215: .I spitbol
216: terminates.
217: .TP
218: EXIT(\fIn\fP)
219: If
220: .I n
221: is greater than 0, a load module will be written in
222: .I a.out
223: before termination.
224: Executing this load module will restore the state of the
225: .I spitbol
226: system to what it was when EXIT was called, except that
227: any files other than the standard input, output, and error
228: will have been closed.
229: To the SNOBOL4 program, it will appear as if
230: EXIT had returned a null string.
231: If
232: .I n
233: is exactly 1,
234: the generated load module will identify
235: the version of
236: .I spitbol
237: that created it in a message when it
238: begins execution.
239: If
240: .I n
241: is greater than 1,
242: it will resume quietly.
243: .TP
244: HOST()
245: returns the host string read from /usr/lib/spithost.
246: .TP
247: HOST(0)
248: returns the string specified with the
249: .B \-u
250: option
251: on the command line.
252: If
253: .B \-u
254: was not specified the
255: null string is returned.
256: .TP
257: HOST(1,"command string")
258: executes the command string
259: and continues.
260: .TP
261: HOST(2,\fIn\fP)
262: returns argument number
263: .I n
264: from the command line.
265: It fails if
266: .I n
267: is out of range or not an integer.
268: .TP
269: HOST(3)
270: returns the index of the first command line argument
271: that was not examined by
272: .IR spitbol .
273: .TP
274: HOST(4,"var")
275: returns the value of the environment variable
276: .IR var .
277: If the value is too long for an internal buffer
278: (presently 512 bytes) it is quietly truncated.
279: .TP
280: HOST(5,n)
281: sets (if n > 0) or resets (if n < 0) a trap for
282: signal number \|n\|
283: (see
284: .IR signal (2)).
285: It returns 0 if no trap was previously set for that signal,
286: 1 if a trap has been previously set but the signal has not occurred since
287: the last call, or 2 if the signal has occurred.
288: .SH "MISCELLANY"
289: A file is not actually opened until the first attempt
290: to read, write, SET, or REWIND it.
291: .PP
292: Folding of names to UPPER CASE can be controlled during compilation
293: by the \-CASE control statement and during execution by the &CASE keyword.
294: A value of 0 prevents folding to UPPER CASE and a value of 1
295: forces folding to UPPER CASE.
296: .PP
297: Integers are represented by 32-bit quantities.
298: Real numbers are implemented in single precision.
299: .PP
300: Setting &STLIMIT = \-1 inhibits statement limit checking and provides
301: a way to execute arbitrarily many statements.
302: .PP
303: The name TERMINAL is available with default associations for input and
304: output to the terminal.
305: .PP
306: If the first line of the first input file begins with
307: .B #!
308: then that line is ignored.
309: This meshes with the way that
310: .IR exec (2)
311: treats files beginning with
312: .BR #! .
313: .PP
314: Setting &PROFILE = 1 causes
315: .I spitbol
316: to accumulate profile information during program execution
317: and print this information after the program terminates.
318: .SH "FILES"
319: /usr/lib/vaxspitv35.err \- Error text.
320: .br
321: /usr/lib/spithost \- Host computer and operating system identifier.
322: .SH "SEE ALSO"
323: .I "Macro SPITBOL Program Reference Manual"
324: by R. B. K. Dewar, A. P. McCann, R. E. Goldberg, and Steven G. Duff
325: .br
326: .I "The SNOBOL4 Programming Language, Second Edition"
327: by R. E. Griswold, J. F. Poage and I. P. Polonsky
328: .br
329: .IR sno (1),
330: .IR snocone (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.