version 1.2, 1997/07/31 16:17:23
|
version 1.6, 2002/08/01 21:14:25
|
Line 3
|
Line 3
|
.ns |
.ns |
.IP "\fB\\$1\fI\\$2" 9 |
.IP "\fB\\$1\fI\\$2" 9 |
.. |
.. |
.TH GForth 1 "April 10, 1997" \" -*- nroff -*- |
.TH GForth 1 "April 14, 1999" \" -*- nroff -*- |
.SH NAME |
.SH NAME |
gforth, gforth-ditc, gforth-makeimage \- a fast and portable Forth system |
gforth, gforth-fast, gforthmi \- a fast and portable Forth system |
.SH SYNOPSIS |
.SH SYNOPSIS |
|
|
\fCgforth\fR [initialization options] [image-specific options] |
\fCgforth\fR [initialization options] [image-specific options] |
|
\fCgforth-fast\fR [initialization options] [image-specific options] |
|
|
\fCgforth-ditc\fR [initialization options] [image-specific options] |
\fCgforthmi\fR \fIfilename\fR [initialization options] [image-specific options] |
|
|
\fCgforth-makeimage\fR \fIfilename\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 |
Line 22 programming language. For details read t
|
Line 21 programming language. For details read t
|
\fCGFORTHPATH\fR contains the search path for source and image files. |
\fCGFORTHPATH\fR contains the search path for source and image files. |
|
|
\fCGFORTHD\fR gives the gforth executable used by |
\fCGFORTHD\fR gives the gforth executable used by |
\fCgforth-makeimage\fR for creating the base images. It should be a |
\fCgforthmi\fR for creating the base images. It should be a |
double indirect threaded system. Default: \fCgforth-ditc\fR. |
double indirect threaded system. Default: \fCgforth-ditc\fR. |
|
|
\fCGFORTH\fR gives the gforth executable used by |
\fCGFORTH\fR gives the gforth executable used by |
\fCgforth-makeimage\fR for computing the relocatable image from the |
\fCgforthmi\fR for computing the relocatable image from the |
base images. Default: \fCgforth\fR. |
base images. Default: \fCgforth\fR. |
|
|
|
\fCGFORTHHIST\fR gives the location of the history file used by gforth |
|
to allow command-line recall. Default: \fC$HOME\fR. (The history |
|
file is named \fC.gforth-history\fR). |
|
|
.SH EXAMPLES |
.SH EXAMPLES |
|
|
\fCgforth\fR |
\fCgforth\fR |
Line 40 starts the system and goes into interact
|
Line 43 starts the system and goes into interact
|
loads and interprets the files \fCfile1\fR and \fCfile2\fR, then |
loads and interprets the files \fCfile1\fR and \fCfile2\fR, then |
exits. |
exits. |
|
|
\fCgforth-makeimage asm.fi \-m 1M asm.fs\fR |
\fCgforth-fast\fR |
|
|
creates an image \fCasm.fi\fR that has a default dictionary size of |
is the same as \fCgforth\fR, except that it does not support |
1MB and has the file \fCasm.fs\fR loaded. |
accurate backtraces for signals, and is faster by up to a factor of 2. |
|
Use it for debugged, performance-critical programs such as benchmarks. |
|
|
\fCgforth-ditc\fR |
\fCgforthmi asm.fi \-m 1M asm.fs\fR |
|
|
starts a doubly indirect threaded version of Gforth and goes into |
creates an image \fCasm.fi\fR that has a default dictionary size of |
interactive mode. |
1MB and has the file \fCasm.fs\fR loaded. |
|
|
.SH OPTIONS |
.SH OPTIONS |
|
|
Line 132 interactive mode) append \fC-e bye\fR to
|
Line 136 interactive mode) append \fC-e bye\fR to
|
image-specific option of the default image. |
image-specific option of the default image. |
.SH FILES |
.SH FILES |
.nf |
.nf |
.ta \w'\fCkernal.fi\fP 'u |
.ta \w'\fC.../gforth.fi\fP 'u |
\&\fCgforth.fi\fP default Forth image |
\&\fC.../gforth.fi\fP default Forth image |
\&\fCkernel.fi\fP kernel image |
|
\&\fC*.fi\fP Forth loadable image |
\&\fC*.fi\fP Forth loadable image |
\&\fC*.fs\fP Forth source (sequential) |
\&\fC*.fs\fP Forth source (sequential) |
\&\fC*.fb\fP Forth source (block) |
\&\fC*.fb\fP Forth source (block) |
Line 144 image-specific option of the default ima
|
Line 147 image-specific option of the default ima
|
\&\fC*TAGS\fP etags files |
\&\fC*TAGS\fP etags files |
.fi |
.fi |
.SH SEE ALSO |
.SH SEE ALSO |
The GForth manual is available in hypertext (Info, HTML) and printable |
The Gforth manual - available in hypertext (Info, HTML) and printable |
(TeX, PS) forms. |
(TeX, PS, ASCII) forms. |
|
|
The ANSI document X3.215-1994 (i.e., the ANS Forth standard). |
The ANSI document X3.215-1994 (i.e., the ANS Forth standard). |
|
|