DragonFly On-Line Manual Pages

SNOBOL4CMD(1)                   CSNOBOL4 Manual                  SNOBOL4CMD(1)

NAME
       snobol4 - SNOBOL4 interpreter command line syntax

SYNOPSIS
       snobol4 [ options ... ] [ file ... ] [ param ... ]

OPTIONS
       -b  Disable start up banner and termination output (only displayed when
           no source files are given on the command line).  In earlier
           releases of CSNOBOL4 -b toggled banner output, and banners were
           enabled by default.

       -d ndesc
           Allocate a ``dynamic storage'' region of ndesc descriptors for
           program code and data. A suffix of k multiplies the number by 1024,
           a suffix of m multiplies the number by 1048576.  A larger dynamic
           region may result in fewer garbage collections (storage
           regenerations), however large values may cause execution to slow
           down when large amounts of garbage collect.  Most programs do not
           need an increased dynamic region to run.  If your program
           terminates with an ``Insufficient storage to continue'' message you
           need to increase the dynamic storage region size.  The -h option
           displays the default dynamic region size.

       -f  Toggle folding of identifiers to upper case (see -CASE and &CASE).

       -g  Enable garbage collection tracing (sets >RACE to -1).

       -h  Give help. Shows usage message, includes default sizes for
           ``dynamic region'' and pattern match stack.

       -k  Toggle running programs with compilation errors (see -ERROR and
           -NOERRORS extensions).  By default programs with compilation errors
           will not be run.

       -l LISTINGFILE
           Enable listing output to the named file. The default listing side
           is LEFT.

       -n  Toggle running programs after compilation (see -EXECUTE and
           -NOEXECUTE extensions).  By default programs are run after
           compilation.

       -p  Toggle SPITBOL extensions (also controlled by -PLUSOPS).

       -r  Toggle reading INPUT from command line / source file(s) after the
           END label.  Otherwise INPUT defaults (back) to standard input after
           program compilation is complete.

       -s  Toggle termination statistics (off by default).

       -u param
           Specify a parameter string available via HOST(0).

       -v  Show version and exit.

       -x  Force banner and termination output.

       -z  Show directory search path in use (including -I options) and exit.

       -I directory
           Appends directory argument to include search path (before elements
           from the SNOLIB or SNOPATH environment variables).

       -L file
           Load source file before others on command line.  May be used
           multiple times.  Used to preload the sdb(1) source code debugger.

       -M  Specifies that all items left on the command line after option
           processing is complete are to be treated as filenames.  The files
           are read in turn until an END statement is found (Any remaining
           data is available via the INPUT variable if the -r option is also
           given).

       -N  Disable standard search path ``no standard include.''

       -P ndesc
           Allocate ndesc descriptors for the pattern match stack.  A suffix
           of k multiplies the number by 1024, a suffix of m multiplies the
           number by 1048576.  The pattern match stack is used to save
           backtracking and conditional assignment information during pattern
           matching.  If your program terminates with an ``Overflow during
           pattern matching'' message (Error 16) you need to increase the
           pattern match stack size.  The -h option displays the default
           pattern match stack size.

       -S ndesc
           Allocate ndesc descriptors for the interpreter stack.  A suffix of
           k multiplies the number by 1024, a suffix of m multiplies the
           number by 1048576.  The interpreter stack is used for saving data,
           and passing parameters to internal procedures. If your program
           terminates with an ``Stack overflow'' message (Error 21) you need
           to increase the interpreter stack size.  A common reason for
           needing additional stack space is for tracing deeply nested DATA()
           structures during garbage collection.  The -h option displays the
           default interpreter stack size.

       --  Terminates processing items as options. Any remaining strings are
           treated as files or user parameters (see the HOST() function).

SEE ALSO
       snobol4(1).

CSNOBOL4B 2.0                   January 1, 2015                  SNOBOL4CMD(1)