Diff for /gforth/doc/gforth.1 between versions 1.2 and 1.6

version 1.2, 1997/07/31 16:17:23 version 1.6, 2002/08/01 21:14:25
Line 3 Line 3
 .ns  .ns
 .IP "\fB\\$1\fI\\$2" 9  .IP "\fB\\$1\fI\\$2" 9
 ..  ..
 .TH GForth 1 "April 10, 1997" \" -*- nroff -*-  .TH GForth 1 "April 14, 1999" \" -*- nroff -*-
 .SH NAME  .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  .SH SYNOPSIS
   
 \fCgforth\fR [initialization options] [image-specific options]  \fCgforth\fR [initialization options] [image-specific options]
   \fCgforth-fast\fR [initialization options] [image-specific options]
   
 \fCgforth-ditc\fR [initialization options] [image-specific options]  \fCgforthmi\fR \fIfilename\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
Line 22  programming language. For details read t Line 21  programming language. For details read t
 \fCGFORTHPATH\fR contains the search path for source and image files.  \fCGFORTHPATH\fR contains the search path for source and image files.
   
 \fCGFORTHD\fR gives the gforth executable used by  \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.  double indirect threaded system.  Default: \fCgforth-ditc\fR.
   
 \fCGFORTH\fR gives the gforth executable used by  \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.  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  .SH EXAMPLES
   
 \fCgforth\fR  \fCgforth\fR
Line 40  starts the system and goes into interact Line 43  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  \fCgforth-fast\fR
   
 creates an image \fCasm.fi\fR that has a default dictionary size of  is the same as \fCgforth\fR, except that it does not support
 1MB and has the file \fCasm.fs\fR loaded.  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  creates an image \fCasm.fi\fR that has a default dictionary size of
 interactive mode.  1MB and has the file \fCasm.fs\fR loaded.
   
 .SH OPTIONS  .SH OPTIONS
   
Line 132  interactive mode) append \fC-e bye\fR to Line 136  interactive mode) append \fC-e bye\fR to
 image-specific option of the default image.  image-specific option of the default image.
 .SH FILES  .SH FILES
 .nf  .nf
 .ta \w'\fCkernal.fi\fP  'u  .ta \w'\fC.../gforth.fi\fP      'u
 \&\fCgforth.fi\fP       default Forth image  \&\fC.../gforth.fi\fP   default Forth 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)
Line 144  image-specific option of the default ima Line 147  image-specific option of the default ima
 \&\fC*TAGS\fP   etags files  \&\fC*TAGS\fP   etags files
 .fi  .fi
 .SH SEE ALSO  .SH SEE ALSO
 The GForth manual is available in hypertext (Info, HTML) and printable  The Gforth manual - available in hypertext (Info, HTML) and printable
 (TeX, PS) forms.  (TeX, PS, ASCII) forms.
   
 The ANSI document X3.215-1994 (i.e., the ANS Forth standard).  The ANSI document X3.215-1994 (i.e., the ANS Forth standard).
   

Removed from v.1.2  
changed lines
  Added in v.1.6


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>