[BACK]Return to gforth.1 CVS log [TXT] [DIR] Up to [gforth] / gforth

Diff for /gforth/Attic/gforth.1 between versions 1.1 and 1.6

version 1.1, 1994/11/30 17:46:05 version 1.6, 1997/03/11 16:00:37
Line 1 Line 1
 .TH GForth 1 "November 27, 1994" \" -*- nroff -*-  .de TQ
   .br
   .ns
   .IP "\fB\\$1\fI\\$2" 9
   ..
   .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
   
Line 24  gives the search path for source files. Line 30  gives the search path for source files.
   
 starts the system and goes into interactive mode.  starts the system and goes into interactive mode.
   
 \fCgforth file1 file2 -e bye\fR  \fCgforth file1 file2 \-e bye\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.
   
 .SH SEE ALSO  \fCgforth 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.
   
   .SH OPTIONS
   
   .BI "\-\-image\-file " "file"
   .TQ "\-i " "file"
   Loads the Forth image
   .I file
   instead of the default \fCgforth.fi\fR.
   .TP
   .BI "\-\-path " "path"
   .TQ "\-p " "path"
   Uses
   .I path
   for searching the image file and Forth source code
   files instead of the default in the environment variable
   \fCGFORTHPATH\fR
   or the path specified at installation time (typically
   \fC/usr/local/lib/gforth:.\fR. A path is given as a 
   .BR : -separated
   list.
   .TP
   .BI "\-\-dictionary\-size " "size"
   .TQ "\-m " "size"
   Allocate
   .I size
   space for the Forth dictionary space instead of
   using the default specified in the image (typically 256K). The
   .I size
   specification consists of an integer and a unit (e.g., \fC4M\fR).
   The unit can be one of \fCb\fR (bytes),
   \fCe\fR (element size, in this case Cells),
   \fCk\fR (kilobytes), and
   \fCM\fR (Megabytes). If no unit is specified,
   \fCe\fR is used.
   .TP
   .BI "\-\-data\-stack\-size " "size"
   .TQ "\-d " "size"
   Allocate
   .I size
   space for the data stack instead of using the
   default specified in the image (typically 16K).
   .TP
   .BI "\-\-return\-stack\-size " "size"
   .TQ "\-r " "size"
   Allocate
   .I size
   space for the return stack instead of using the
   default specified in the image (typically 16K).
   .TP
   .BI "\-\-fp\-stack\-size " "size"
   .TQ "\-f " "size"
   Allocate
   .I size
   space for the floating point stack instead of
   using the default specified in the image (typically 16K). In this case
   the unit specifier
   \fCe\fR
   refers to floating point numbers.
   .TP
   .BI "\-\-locals\-stack\-size " "size"
   .TQ "\-l " "size"
   Allocate
   .I size
   space for the locals stack instead of using the
   default specified in the image (typically 16K).
   
   .TP
   .BI "\-\-evaluate " "forth"
   .TQ "\-e " "forth"
   Evaluates the
   .I forth
   code. This option takes only one argument; if you want to evaluate
   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.
   .SH FILES
   .nf
   .ta \w'\fCkernal.fi\fP  'u
   \&\fCgforth.fi\fP       default Forth image
   \&\fCkernel.fi\fP       kernel image
   \&\fC*.fi\fP    Forth loadable image
   \&\fC*.fs\fP    Forth source (sequential)
   \&\fC*.fb\fP    Forth source (block)
   \&\fC*.fd\fP    generated with \fCmakedoc.fs\fP
   \&\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  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
   manual on the WWW and to papers about Gforth) is available through
   \fChttp://www.complang.tuwien.ac.at/projects/forth.html\fR.
   .SH AUTHORS
   \fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and
   others.
Removed from v.1.1  
changed lines
  Added in v.1.6

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