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.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>