Return to gforth.1 CVS log

Up to [gforth] / gforth

Annotation of gforth/gforth.1, revision 1.5

1.3       pazsan      1: .de TQ
                      2: .br
                      3: .ns
                      4: .IP "\fB\\$1\fI\\$2" 9
                      5: ..
                      6: .TH GForth 1 "October 29, 1995" \" -*- nroff -*-
1.1       anton       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: 
1.3       pazsan     27: \fCgforth file1 file2 \-e bye\fR
1.1       anton      28: 
                     29: loads and interprets the files \fCfile1\fR and \fCfile2\fR, then
                     30: exits.
1.3       pazsan     31: .SH OPTIONS
1.1       anton      32: 
1.3       pazsan     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
1.4       anton     116: \&\fC*.ds\fP   documentation source
1.3       pazsan    117: \&\fC*TAGS\fP  etags files
1.5     ! pazsan    118: .fi
1.1       anton     119: .SH SEE ALSO
                    120: The GForth manual is available in hypertext (Info, HTML) and printable
                    121: (TeX, PS) forms.
                    122: 
1.4       anton     123: The ANSI document X3.215-1994 (i.e., the ANS Forth standard).
1.2       anton     124: 
                    125: More information on Gforth (e.g., pointers to new versions, to the
                    126: manual on the WWW and to papers about Gforth) is available through
                    127: \fChttp://www.complang.tuwien.ac.at/projects/forth.html\fR.
1.3       pazsan    128: .SH AUTHORS
                    129: \fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and
                    130: others.