SNOBOL4CTRL(1) | CSNOBOL4B 2.3.2 | Janurary 1, 2024

NAME

snobol4ctrl – SNOBOL4 control lines

DESCRIPTION

-BLOCKS
Enable BLOCKS operators, see snobol4blocks(1). CSNOBOL4 extension, added in CSNOBOL4 version 2.0.

-CASE
To disable case folding in compiler, use -CASE 0. To re-enable case folding use -CASE n, where n is a non-zero integer. SPITBOL? extension, added in CSNOBOL4 version 0.91.

-COPY
A synonym for -INCLUDE. SPITBOL/370 extension, added in CSNOBOL4 version 0.91.

-EJECT
Output page break in listing. Standard.

-ERRORS
Enables program execution even if the compiler detected errors. Any attempt to execute a statement with a compiler error will cause a fatal execution error. By default programs with compiler errors will not be started. SPITBOL? extension, added before CSNOBOL4 version 0.90.

-EXECUTE
Cancels any previous -NOEXECUTE. SPITBOL extension, added in CSNOBOL4 version 0.98.1.

-HIDE
Disable listing; statement numbers will not be assigned until next -LIST directive. (used for sdb(1) debugger source code). CSNOBOL4 Extension, added in version 1.5.

-INCLUDE
Interpolate the contents of the named file enclosed in single or double quotes. Trailing spaces are removed from the filename before use. Any filename will be included only once, this can be overridden by appending a trailing space to the filename. If the file is not found in the current working directory an attempt will be made to find it in the directories specified in the search path. SPITBOL Extension, added in CSNOBOL4 version 0.91.

-LINE
Takes a line number, and optionally a filename in quotes. Output by preprocessors to indicate original source file and line number to be returned by &FILE, &LINE, &LASTFILE and &LASTLINE. SPITBOL Extension, added in CSNOBOL4 version 0.98.2.

-LIST
Re-enables listing from previous -UNLIST or -HIDE. With optional LEFT or RIGHT controls side of page for statement numbers. Standard (defaults to LEFT since CSNOBOL4 0.90).

-NOBLOCKS
Disable BLOCKS extension. See see snobol4blocks(1). CSNOBOL4 extension, added in CSNOBOL4 version 2.0.

-NOERRORS
Disable effect of -ERROR directive. SPITBOL? extension, added before CSNOBOL4 version 0.90.

-NOEXECUTE
Disables execution of the program. SPITBOL extension, added in CSNOBOL4 version 0.98.1.

-PLUSOPS
With no argument, or zero, disables SPITBOL extensions listed in snobol4ext(1). With a non-zero integer argument, re-enables SPITBOL extensions. SNOBOL4+ extension, added in CSNOBOL4 version 0.98.

-UNLIST
Disable listing. Standard.

SEE ALSO

snobol4(1), snobol4key(1), sdb(1).