| .. |
.. |
| .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 |
| |
|
| 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" |
| 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) |
| \&\fC*.fd\fP generated with \fCmakedoc.fs\fP |
\&\fC*.fd\fP generated with \fCmakedoc.fs\fP |
| \&\fC*.i\fP C include files |
\&\fC*.i\fP C include files |
| \&\fC*.ds\fP C documentation source |
\&\fC*.ds\fP documentation source |
| \&\fC*TAGS\fP etags files |
\&\fC*TAGS\fP etags files |
| |
.fi |
| .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. |
| |
|
| The ANS Forth document (i.e., the standard). |
The ANSI document X3.215-1994 (i.e., the ANS Forth standard). |
| |
|
| 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 |
