--- gforth/Attic/gforth.1 1995/11/07 18:06:40 1.4 +++ gforth/Attic/gforth.1 1997/04/10 15:00:05 1.8 @@ -3,21 +3,32 @@ .ns .IP "\fB\\$1\fI\\$2" 9 .. -.TH GForth 1 "October 29, 1995" \" -*- nroff -*- +.TH GForth 1 "April 10, 1997" \" -*- nroff -*- .SH NAME - -GForth +gforth, gforth-ditc, gforth-makeimage \- a fast and portable Forth system .SH SYNOPSIS \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 \fBGForth\fR is a fast and portable implementation of the Forth programming language. For details read the manual. .SH ENVIRONMENT VARIABLES -\fCGFORTHPATH\fR -gives the search path for source files. +\fCGFORTHPATH\fR contains the search path for source and image files. + +\fCGFORTHD\fR gives the gforth executable used by +\fCgforth-makeimage\fR for creating the base images. It should be a +double indirect threaded system. Default: \fCgforth-ditc\fR. + +\fCGFORTH\fR gives the gforth executable used by +\fCgforth-makeimage\fR for computing the relocatable image from the +base images. Default: \fCgforth\fR. + .SH EXAMPLES \fCgforth\fR @@ -28,6 +39,17 @@ starts the system and goes into interact loads and interprets the files \fCfile1\fR and \fCfile2\fR, then 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 .BI "\-\-image\-file " "file" @@ -102,12 +124,12 @@ code. This option takes only one argumen 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. +image-specific option of the default image. .SH FILES .nf .ta \w'\fCkernal.fi\fP 'u \&\fCgforth.fi\fP default Forth image -\&\fCkernal.fi\fP kernel image +\&\fCkernel.fi\fP kernel image \&\fC*.fi\fP Forth loadable image \&\fC*.fs\fP Forth source (sequential) \&\fC*.fb\fP Forth source (block) @@ -115,6 +137,7 @@ image-specific option. \&\fC*.i\fP C include files \&\fC*.ds\fP documentation source \&\fC*TAGS\fP etags files +.fi .SH SEE ALSO The GForth manual is available in hypertext (Info, HTML) and printable (TeX, PS) forms.