GForth(1)

NAME
GForth

SYNOPSIS
gforth [initialization options] [image-specific options]

DESCRIPTION
GForth is a fast and portable implementation of the Forth programming language. For details read the manual.

ENVIRONMENT VARIABLES
GFORTHPATH gives the search path for source files.

EXAMPLES
gforth starts the system and goes into interactive mode. gforth file1 file2 -e bye loads and interprets the files file1 and file2, then exits.

OPTIONS
--image-file file
Loads the Forth image
    file instead of the default gforth.fi.

--path path
Uses
    path for searching the image file and Forth source code files instead of the default in the environment variable GFORTHPATH or the path specified at installation time (typically /usr/local/lib/gforth:.. A path is given as a :-separated list.

--dictionary-size size
Allocate
    size space for the Forth dictionary space instead of using the default specified in the image (typically 256K). The size specification consists of an integer and a unit (e.g., 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
Allocate
    size space for the data stack instead of using the default specified in the image (typically 16K).

--return-stack-size size
Allocate
    size space for the return stack instead of using the default specified in the image (typically 16K).

--fp-stack-size size
Allocate
    size space for the floating point stack instead of using the default specified in the image (typically 16K). In this case the unit specifier e refers to floating point numbers.

--locals-stack-size size
Allocate
    size space for the locals stack instead of using the default specified in the image (typically 16K).

--evaluate forth
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 -es. To exit after processing the command line (instead of entering interactive mode) append -e bye to the command line. This is an image-specific option.

FILES
gforth.fi	default Forth image
kernal.fi	kernel image
*.fi	Forth loadable image
*.fs	Forth source (sequential)
*.fb	Forth source (block)
*.fd	generated with makedoc.fs
*.i	C include files
*.ds	documentation source
*TAGS	etags files

SEE ALSO
The GForth manual is available in hypertext (Info, HTML) and printable (TeX, PS) forms. The ANSI document X3.215-1994 (i.e., the ANS Forth standard). More information on Gforth (e.g., pointers to new versions, to the manual on the WWW and to papers about Gforth) is available through http://www.complang.tuwien.ac.at/projects/forth.html.

AUTHORS
Gforth was written by Anton Ertl, Bernd Paysan, Jens Wilke and others.