version 1.2, 1995/10/07 17:38:13
|
version 1.3, 1995/10/29 21:35:11
|
Line 1
|
Line 1
|
.TH GForth 1 "November 27, 1994" \" -*- nroff -*- |
.de TQ |
|
.br |
|
.ns |
|
.IP "\fB\\$1\fI\\$2" 9 |
|
.. |
|
.TH GForth 1 "October 29, 1995" \" -*- nroff -*- |
.SH NAME |
.SH NAME |
|
|
GForth |
GForth |
|
|
.SH SYNOPSIS |
.SH SYNOPSIS |
|
|
\fCgforth\fR [initialization options] [image-specific options] |
\fCgforth\fR [initialization options] [image-specific options] |
|
|
.SH DESCRIPTION |
.SH DESCRIPTION |
|
|
\fBGForth\fR is a fast and portable implementation of the Forth |
\fBGForth\fR is a fast and portable implementation of the Forth |
programming language. For details read the manual. |
programming language. For details read the manual. |
|
|
.SH ENVIRONMENT VARIABLES |
.SH ENVIRONMENT VARIABLES |
|
|
\fCGFORTHPATH\fR |
\fCGFORTHPATH\fR |
gives the search path for source files. |
gives the search path for source files. |
|
|
.SH EXAMPLES |
.SH EXAMPLES |
|
|
\fCgforth\fR |
\fCgforth\fR |
|
|
starts the system and goes into interactive mode. |
starts the system and goes into interactive mode. |
|
|
\fCgforth file1 file2 -e bye\fR |
\fCgforth file1 file2 \-e bye\fR |
|
|
loads and interprets the files \fCfile1\fR and \fCfile2\fR, then |
loads and interprets the files \fCfile1\fR and \fCfile2\fR, then |
exits. |
exits. |
|
.SH OPTIONS |
|
|
|
.BI "\-\-image\-file " "file" |
|
.TQ "\-i " "file" |
|
Loads the Forth image |
|
.I file |
|
instead of the default \fCgforth.fi\fR. |
|
.TP |
|
.BI "\-\-path " "path" |
|
.TQ "\-p " "path" |
|
Uses |
|
.I path |
|
for searching the image file and Forth source code |
|
files instead of the default in the environment variable |
|
\fCGFORTHPATH\fR |
|
or the path specified at installation time (typically |
|
\fC/usr/local/lib/gforth:.\fR. A path is given as a |
|
.BR : -separated |
|
list. |
|
.TP |
|
.BI "\-\-dictionary\-size " "size" |
|
.TQ "\-m " "size" |
|
Allocate |
|
.I size |
|
space for the Forth dictionary space instead of |
|
using the default specified in the image (typically 256K). The |
|
.I size |
|
specification consists of an integer and a unit (e.g., \fC4M\fR). |
|
The unit can be one of \fCb\fR (bytes), |
|
\fCe\fR (element size, in this case Cells), |
|
\fCk\fR (kilobytes), and |
|
\fCM\fR (Megabytes). If no unit is specified, |
|
\fCe\fR is used. |
|
.TP |
|
.BI "\-\-data\-stack\-size " "size" |
|
.TQ "\-d " "size" |
|
Allocate |
|
.I size |
|
space for the data stack instead of using the |
|
default specified in the image (typically 16K). |
|
.TP |
|
.BI "\-\-return\-stack\-size " "size" |
|
.TQ "\-r " "size" |
|
Allocate |
|
.I size |
|
space for the return stack instead of using the |
|
default specified in the image (typically 16K). |
|
.TP |
|
.BI "\-\-fp\-stack\-size " "size" |
|
.TQ "\-f " "size" |
|
Allocate |
|
.I size |
|
space for the floating point stack instead of |
|
using the default specified in the image (typically 16K). In this case |
|
the unit specifier |
|
\fCe\fR |
|
refers to floating point numbers. |
|
.TP |
|
.BI "\-\-locals\-stack\-size " "size" |
|
.TQ "\-l " "size" |
|
Allocate |
|
.I size |
|
space for the locals stack instead of using the |
|
default specified in the image (typically 16K). |
|
|
|
.TP |
|
.BI "\-\-evaluate " "forth" |
|
.TQ "\-e " "forth" |
|
Evaluates the |
|
.I forth |
|
code. This option takes only one argument; if you want to evaluate |
|
more Forth words, you have to quote them or use several \fC-e\fRs. To |
|
exit after processing the command line (instead of entering |
|
interactive mode) append \fC-e bye\fR to the command line. This is an |
|
image-specific option. |
|
.SH FILES |
|
.nf |
|
.ta \w'\fCkernal.fi\fP 'u |
|
\&\fCgforth.fi\fP default Forth image |
|
\&\fCkernal.fi\fP kernel image |
|
\&\fC*.fi\fP Forth loadable image |
|
\&\fC*.fs\fP Forth source (sequential) |
|
\&\fC*.fb\fP Forth source (block) |
|
\&\fC*.fd\fP generated with \fCmakedoc.fs\fP |
|
\&\fC*.i\fP C include files |
|
\&\fC*.ds\fP C documentation source |
|
\&\fC*TAGS\fP etags files |
.SH SEE ALSO |
.SH SEE ALSO |
|
|
The GForth manual is available in hypertext (Info, HTML) and printable |
The GForth manual is available in hypertext (Info, HTML) and printable |
(TeX, PS) forms. |
(TeX, PS) forms. |
|
|
Line 39 The ANS Forth document (i.e., the standa
|
Line 124 The ANS Forth document (i.e., the standa
|
More information on Gforth (e.g., pointers to new versions, to the |
More information on Gforth (e.g., pointers to new versions, to the |
manual on the WWW and to papers about Gforth) is available through |
manual on the WWW and to papers about Gforth) is available through |
\fChttp://www.complang.tuwien.ac.at/projects/forth.html\fR. |
\fChttp://www.complang.tuwien.ac.at/projects/forth.html\fR. |
|
.SH AUTHORS |
|
\fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and |
|
others. |