version 1.2, 1997/07/31 16:17:23
|
version 1.3, 1998/12/24 11:08:40
|
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 "December 24, 1998" \" -*- nroff -*- |
.SH NAME |
.SH NAME |
gforth, gforth-ditc, gforth-makeimage \- a fast and portable Forth system |
gforth, 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-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 20 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. |
|
|
.SH EXAMPLES |
.SH EXAMPLES |
Line 40 starts the system and goes into interact
|
Line 38 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 |
\fCgforthmi asm.fi \-m 1M asm.fs\fR |
|
|
creates an image \fCasm.fi\fR that has a default dictionary size of |
creates an image \fCasm.fi\fR that has a default dictionary size of |
1MB and has the file \fCasm.fs\fR loaded. |
1MB and has the file \fCasm.fs\fR loaded. |
|
|
\fCgforth-ditc\fR |
|
|
|
starts a doubly indirect threaded version of Gforth and goes into |
|
interactive mode. |
|
|
|
.SH OPTIONS |
.SH OPTIONS |
|
|
.BI "\-\-help" |
.BI "\-\-help" |
Line 132 interactive mode) append \fC-e bye\fR to
|
Line 125 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) |