Diff for /gforth/Attic/gforth.texi between versions 1.6 and 1.7

version 1.6, 1994/08/31 16:37:46 version 1.7, 1994/09/05 17:36:19
Line 171  other languages should find it ok. Line 171  other languages should find it ok.
 @node Invocation, Words, Other Books, Top  @node Invocation, Words, Other Books, Top
 @chapter Invocation  @chapter Invocation
   
 You will usually just say @code{gforth}. More generally, the default GNU  You will usually just say @code{gforth}. In many other cases the default
 Forth image can be invoked like this  GNU Forth image will be invoked like this:
   
 @example  @example
 gforth [--batch] [files] [-e forth-code]  gforth [files] [-e forth-code]
 @end example  @end example
   
 The @code{--batch} option makes @code{gforth} exit after processing the  executing the contents of the files and the Forth code in the order they
 command line. Also, the startup message is suppressed. @file{files} are  are given.
 Forth source files that are executed in the order in which they  
 appear. The @code{-e @samp{forth-code}} or @code{--evaluate  In general, the command line looks like this:
 @samp{forth-code}} option evaluates the forth code; it can be freely  
 mixed with the files. This option takes only one argument; if you want  @example
 to evaluate more Forth words, you have to quote them or use several  gforth [initialization options] [image-specific options]
 @code{-e}s. !! option for suppressing default loading.  @end example
   
 You can use the command line option @code{-i @samp{file}} or  The initialization options must come before the rest of the command
 @code{--image-file @samp{file}} to specify a different image file. Note  line. They are:
 that this option must be the first in the command line. The rest of the  
 command line is processed by the image file.  @table @code
   @item --image-file @samp{file}
 If the @code{--image-file} option is not used, GNU Forth searches for a  Loads the Forth image @samp{file} instead of the default
 file named @file{gforth.fi} in the path specified by the environment  @file{gforth.fi}.
 variable @code{GFORTHPATH}; if this does not exist, in  
 @file{/usr/local/lib/gforth} and in @file{/usr/lib/gforth}.  @item --path @samp{path}
   Uses @samp{path} for searching the image file and Forth source code
   files instead of the default in the environment variable
   @code{GFORTHPATH} or the path specified at installation time (typically
   @file{/usr/local/lib/gforth:.}). A path is given as a @code{:}-separated
   list.
   
   @item --dictionary-size @samp{size}
   @item -m @samp{size}
   Allocate @samp{size} space for the Forth dictionary space instead of
   using the default specified in the image (typically 256K). The
   @samp{size} specification consists of an integer and a unit (e.g.,
   @code{4M}). The unit can be one of @code{b} (bytes), @code{e} (element
   size, in this case Cells), @code{k} (kilobytes), and @code{M}
   (Megabytes). If no unit is specified, @code{e} is used.
   
   @item --data-stack-size @samp{size}
   @item -d @samp{size}
   Allocate @samp{size} space for the data stack instead of using the
   default specified in the image (typically 16K).
   
   @item --return-stack-size @samp{size}
   @item -r @samp{size}
   Allocate @samp{size} space for the return stack instead of using the
   default specified in the image (typically 16K).
   
   @item --fp-stack-size @samp{size}
   @item -f @samp{size}
   Allocate @samp{size} space for the floating point stack instead of
   using the default specified in the image (typically 16K). In this case
   the unit specifier @code{e} refers to floating point numbers.
   
   @item --locals-stack-size @samp{size}
   @item -l @samp{size}
   Allocate @samp{size} space for the locals stack instead of using the
   default specified in the image (typically 16K).
   
   @end table
   
   As explained above, the image-specific command-line arguments for the
   default image @file{gforth.fi} consist of a sequence of filenames and
   @code{-e @samp{forth-code}} options that are interpreted in the seqence
   in which they are given. The @code{-e @samp{forth-code}} or
   @code{--evaluate @samp{forth-code}} option evaluates the forth
   code. This option takes only one argument; if you want to evaluate more
   Forth words, you have to quote them or use several @code{-e}s. To exit
   after processing the command line (instead of entering interactive mode)
   append @code{-e bye} to the command line.
   
   Not yet implemented:
   On startup the system first executes the system initialization file
   (unless the option @code{--no-init-file} is given; note that the system
   resulting from using this option may not be ANS Forth conformant). Then
   the user initialization file @file{.gforth.fs} is executed, unless the
   option @code{--no-rc} is given; this file is first searched in @file{.},
   then in @file{~}, then in the path given by the normal path (see below).
   
 @node Words,  , Invocation, Top  @node Words,  , Invocation, Top
 @chapter Forth Words  @chapter Forth Words

Removed from v.1.6  
changed lines
  Added in v.1.7


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>