--- gforth/doc/gforth.1 1998/12/24 11:08:40 1.3 +++ gforth/doc/gforth.1 2000/09/23 18:20:19 1.5 @@ -3,12 +3,13 @@ .ns .IP "\fB\\$1\fI\\$2" 9 .. -.TH GForth 1 "December 24, 1998" \" -*- nroff -*- +.TH GForth 1 "April 14, 1999" \" -*- nroff -*- .SH NAME -gforth, gforthmi \- a fast and portable Forth system +gforth, gforth-fast, gforthmi \- a fast and portable Forth system .SH SYNOPSIS \fCgforth\fR [initialization options] [image-specific options] +\fCgforth-fast\fR [initialization options] [image-specific options] \fCgforthmi\fR \fIfilename\fR [initialization options] [image-specific options] .SH DESCRIPTION @@ -27,6 +28,10 @@ double indirect threaded system. Defaul \fCgforthmi\fR for computing the relocatable image from the 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 \fCgforth\fR @@ -38,6 +43,12 @@ starts the system and goes into interact loads and interprets the files \fCfile1\fR and \fCfile2\fR, then exits. +\fCgforth-fast\fR + +is the same as \fCgforth-fast\fR, except that it does not support +accurate backtraces for signals, and is faster by up to a factor of 2. +Use it for debugged, performance-critical programs such as benchmarks. + \fCgforthmi asm.fi \-m 1M asm.fs\fR creates an image \fCasm.fi\fR that has a default dictionary size of @@ -136,8 +147,8 @@ image-specific option of the default ima \&\fC*TAGS\fP etags files .fi .SH SEE ALSO -The GForth manual is available in hypertext (Info, HTML) and printable -(TeX, PS) forms. +The Gforth manual - available in hypertext (Info, HTML) and printable +(TeX, PS, ASCII) forms. The ANSI document X3.215-1994 (i.e., the ANS Forth standard).