You will usually just say gforth
. In many other cases the default
Gforth image will be invoked like this:
gforth [files] [-e forth-code]
executing the contents of the files and the Forth code in the order they are given.
In general, the command line looks like this:
gforth [initialization options] [image-specific options]
The initialization options must come before the rest of the command line. They are:
--image-file file
-i file
--path path
-p path
GFORTHPATH
or
the path specified at installation time (e.g.,
`/usr/local/share/gforth/0.2.0:.'). A path is given as a list of
directories, separated by `:' (on Unix) or `;' (on other OSs).
--dictionary-size size
-m size
4M
). The unit can be one of b
(bytes), e
(element
size, in this case Cells), k
(kilobytes), and M
(Megabytes). If no unit is specified, e
is used.
--data-stack-size size
-d size
--return-stack-size size
-r size
--fp-stack-size size
-f size
e
refers to floating point numbers.
--locals-stack-size size
-l size
As explained above, the image-specific command-line arguments for the
default image `gforth.fi' consist of a sequence of filenames and
-e forth-code
options that are interpreted in the seqence
in which they are given. The -e forth-code
or
--evaluate 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 -e
s. To exit
after processing the command line (instead of entering interactive mode)
append -e bye
to the command line.
If you have several versions of Gforth installed, gforth
will
invoke the version that was installed last. gforth-version
invokes a specific version. You may want to use the option
--path
, if your environment contains the variable
GFORTHPATH
.
Not yet implemented:
On startup the system first executes the system initialization file
(unless the option --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 `.gforth.fs' is executed, unless the
option --no-rc
is given; this file is first searched in `.',
then in `~', then in the normal path (see above).