File:  [gforth] / gforth / Attic / gforth.1
Revision 1.4: download - view: text, annotated - select for diffs
Tue Nov 7 18:06:40 1995 UTC (28 years, 4 months ago) by anton
Branches: MAIN
CVS tags: gforth-0_1beta, HEAD
added copyright headers
changes to loadfilename & co. to make savesystem transparent to
 assertions and ~~

    1: .de TQ
    2: .br
    3: .ns
    4: .IP "\fB\\$1\fI\\$2" 9
    5: ..
    6: .TH GForth 1 "October 29, 1995" \" -*- nroff -*-
    7: .SH NAME
    8: 
    9: GForth
   10: .SH SYNOPSIS
   11: 
   12: \fCgforth\fR [initialization options] [image-specific options]
   13: .SH DESCRIPTION
   14: 
   15: \fBGForth\fR is a fast and portable implementation of the Forth
   16: programming language. For details read the manual.
   17: .SH ENVIRONMENT VARIABLES
   18: 
   19: \fCGFORTHPATH\fR
   20: gives the search path for source files.
   21: .SH EXAMPLES
   22: 
   23: \fCgforth\fR
   24: 
   25: starts the system and goes into interactive mode.
   26: 
   27: \fCgforth file1 file2 \-e bye\fR
   28: 
   29: loads and interprets the files \fCfile1\fR and \fCfile2\fR, then
   30: exits.
   31: .SH OPTIONS
   32: 
   33: .BI "\-\-image\-file " "file"
   34: .TQ "\-i " "file"
   35: Loads the Forth image
   36: .I file
   37: instead of the default \fCgforth.fi\fR.
   38: .TP
   39: .BI "\-\-path " "path"
   40: .TQ "\-p " "path"
   41: Uses
   42: .I path
   43: for searching the image file and Forth source code
   44: files instead of the default in the environment variable
   45: \fCGFORTHPATH\fR
   46: or the path specified at installation time (typically
   47: \fC/usr/local/lib/gforth:.\fR. A path is given as a 
   48: .BR : -separated
   49: list.
   50: .TP
   51: .BI "\-\-dictionary\-size " "size"
   52: .TQ "\-m " "size"
   53: Allocate
   54: .I size
   55: space for the Forth dictionary space instead of
   56: using the default specified in the image (typically 256K). The
   57: .I size
   58: specification consists of an integer and a unit (e.g., \fC4M\fR).
   59: The unit can be one of \fCb\fR (bytes),
   60: \fCe\fR (element size, in this case Cells),
   61: \fCk\fR (kilobytes), and
   62: \fCM\fR (Megabytes). If no unit is specified,
   63: \fCe\fR is used.
   64: .TP
   65: .BI "\-\-data\-stack\-size " "size"
   66: .TQ "\-d " "size"
   67: Allocate
   68: .I size
   69: space for the data stack instead of using the
   70: default specified in the image (typically 16K).
   71: .TP
   72: .BI "\-\-return\-stack\-size " "size"
   73: .TQ "\-r " "size"
   74: Allocate
   75: .I size
   76: space for the return stack instead of using the
   77: default specified in the image (typically 16K).
   78: .TP
   79: .BI "\-\-fp\-stack\-size " "size"
   80: .TQ "\-f " "size"
   81: Allocate
   82: .I size
   83: space for the floating point stack instead of
   84: using the default specified in the image (typically 16K). In this case
   85: the unit specifier
   86: \fCe\fR
   87: refers to floating point numbers.
   88: .TP
   89: .BI "\-\-locals\-stack\-size " "size"
   90: .TQ "\-l " "size"
   91: Allocate
   92: .I size
   93: space for the locals stack instead of using the
   94: default specified in the image (typically 16K).
   95: 
   96: .TP
   97: .BI "\-\-evaluate " "forth"
   98: .TQ "\-e " "forth"
   99: Evaluates the
  100: .I forth
  101: code. This option takes only one argument; if you want to evaluate
  102: more Forth words, you have to quote them or use several \fC-e\fRs.  To
  103: exit after processing the command line (instead of entering
  104: interactive mode) append \fC-e bye\fR to the command line. This is an
  105: image-specific option.
  106: .SH FILES
  107: .nf
  108: .ta \w'\fCkernal.fi\fP 	'u
  109: \&\fCgforth.fi\fP	default Forth image
  110: \&\fCkernal.fi\fP	kernel image
  111: \&\fC*.fi\fP	Forth loadable image
  112: \&\fC*.fs\fP	Forth source (sequential)
  113: \&\fC*.fb\fP	Forth source (block)
  114: \&\fC*.fd\fP	generated with \fCmakedoc.fs\fP
  115: \&\fC*.i\fP	C include files
  116: \&\fC*.ds\fP	documentation source
  117: \&\fC*TAGS\fP	etags files
  118: .SH SEE ALSO
  119: The GForth manual is available in hypertext (Info, HTML) and printable
  120: (TeX, PS) forms.
  121: 
  122: The ANSI document X3.215-1994 (i.e., the ANS Forth standard).
  123: 
  124: More information on Gforth (e.g., pointers to new versions, to the
  125: manual on the WWW and to papers about Gforth) is available through
  126: \fChttp://www.complang.tuwien.ac.at/projects/forth.html\fR.
  127: .SH AUTHORS
  128: \fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and
  129: others.

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