--- gforth/doc/gforth.1	1997/07/31 16:17:23	1.2
+++ gforth/doc/gforth.1	2000/09/23 18:20:19	1.5
@@ -3,16 +3,15 @@
 .ns
 .IP "\fB\\$1\fI\\$2" 9
 ..
-.TH GForth 1 "April 10, 1997" \" -*- nroff -*-
+.TH GForth 1 "April 14, 1999" \" -*- nroff -*-
 .SH NAME
-gforth, gforth-ditc, gforth-makeimage \- 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]
 
-\fCgforth-ditc\fR [initialization options] [image-specific options]
-
-\fCgforth-makeimage\fR \fIfilename\fR [initialization options] [image-specific options]
+\fCgforthmi\fR \fIfilename\fR [initialization options] [image-specific options]
 .SH DESCRIPTION
 
 \fBGForth\fR is a fast and portable implementation of the Forth
@@ -22,13 +21,17 @@ programming language. For details read t
 \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
+\fCgforthmi\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
+\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
@@ -40,15 +43,16 @@ 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
+\fCgforth-fast\fR
 
-creates an image \fCasm.fi\fR that has a default dictionary size of
-1MB and has the file \fCasm.fs\fR loaded.
+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.
 
-\fCgforth-ditc\fR
+\fCgforthmi asm.fi \-m 1M asm.fs\fR
 
-starts a doubly indirect threaded version of Gforth and goes into
-interactive mode.
+creates an image \fCasm.fi\fR that has a default dictionary size of
+1MB and has the file \fCasm.fs\fR loaded.
 
 .SH OPTIONS
 
@@ -132,9 +136,8 @@ interactive mode) append \fC-e bye\fR to
 image-specific option of the default image.
 .SH FILES
 .nf
-.ta \w'\fCkernal.fi\fP 	'u
-\&\fCgforth.fi\fP	default Forth image
-\&\fCkernel.fi\fP	kernel image
+.ta \w'\fC.../gforth.fi\fP 	'u
+\&\fC.../gforth.fi\fP	default Forth image
 \&\fC*.fi\fP	Forth loadable image
 \&\fC*.fs\fP	Forth source (sequential)
 \&\fC*.fb\fP	Forth source (block)
@@ -144,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).