version 1.5, 1996/05/07 16:15:21
|
version 1.7, 1997/03/19 18:27:14
|
Line 5
|
Line 5
|
.. |
.. |
.TH GForth 1 "October 29, 1995" \" -*- nroff -*- |
.TH GForth 1 "October 29, 1995" \" -*- nroff -*- |
.SH NAME |
.SH NAME |
|
gforth, gforth-ditc, gforth-makeimage \- a fast and portable Forth system |
GForth |
|
.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] |
|
|
|
\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 |
programming language. For details read the manual. |
programming language. For details read the manual. |
.SH ENVIRONMENT VARIABLES |
.SH ENVIRONMENT VARIABLES |
|
|
\fCGFORTHPATH\fR |
\fCGFORTHPATH\fR contains the search path for source and image files. |
gives the search path for source files. |
|
|
\fCGFORTHD\fR gives the gforth executable to be used in creating the |
|
image (default: \fCgforth-ditc\fR). |
|
|
.SH EXAMPLES |
.SH EXAMPLES |
|
|
\fCgforth\fR |
\fCgforth\fR |
Line 28 starts the system and goes into interact
|
Line 34 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 |
|
|
|
creates an image \fCasm.fi\fR that has a default dictionary size of |
|
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 "\-\-image\-file " "file" |
.BI "\-\-image\-file " "file" |
Line 102 code. This option takes only one argumen
|
Line 119 code. This option takes only one argumen
|
more Forth words, you have to quote them or use several \fC-e\fRs. To |
more Forth words, you have to quote them or use several \fC-e\fRs. To |
exit after processing the command line (instead of entering |
exit after processing the command line (instead of entering |
interactive mode) append \fC-e bye\fR to the command line. This is an |
interactive mode) append \fC-e bye\fR to the command line. This is an |
image-specific option. |
image-specific option of the default image. |
.SH FILES |
.SH FILES |
.nf |
.nf |
.ta \w'\fCkernal.fi\fP 'u |
.ta \w'\fCkernal.fi\fP 'u |
\&\fCgforth.fi\fP default Forth image |
\&\fCgforth.fi\fP default Forth image |
\&\fCkernal.fi\fP kernel 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) |