Return to gforth.1 CVS log

Up to [gforth] / gforth

Annotation of gforth/gforth.1, revision 1.3

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
        !           116: \&\fC*.ds\fP   C documentation source
        !           117: \&\fC*TAGS\fP  etags files
1.1       anton     118: .SH SEE ALSO
                    119: The GForth manual is available in hypertext (Info, HTML) and printable
                    120: (TeX, PS) forms.
                    121: 
                    122: The ANS Forth document (i.e., the standard).
1.2       anton     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.
1.3     ! pazsan    127: .SH AUTHORS
        !           128: \fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and
        !           129: others.