Powered by ViewCVS 1.0-dev
| 1 : | pazsan | 1.3 | .de TQ |
| 2 : | .br | ||
| 3 : | .ns | ||
| 4 : | .IP "\fB\\$1\fI\\$2" 9 | ||
| 5 : | .. | ||
| 6 : | .TH GForth 1 "October 29, 1995" \" -*- nroff -*- | ||
| 7 : | anton | 1.1 | .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 : | pazsan | 1.3 | \fCgforth file1 file2 \-e bye\fR |
| 28 : | anton | 1.1 | |
| 29 : | loads and interprets the files \fCfile1\fR and \fCfile2\fR, then | ||
| 30 : | exits. | ||
| 31 : | pazsan | 1.3 | .SH OPTIONS |
| 32 : | anton | 1.1 | |
| 33 : | pazsan | 1.3 | .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 : | anton | 1.4 | \&\fC*.ds\fP documentation source |
| 117 : | pazsan | 1.3 | \&\fC*TAGS\fP etags files |
| 118 : | anton | 1.1 | .SH SEE ALSO |
| 119 : | The GForth manual is available in hypertext (Info, HTML) and printable | ||
| 120 : | (TeX, PS) forms. | ||
| 121 : | |||
| 122 : | anton | 1.4 | The ANSI document X3.215-1994 (i.e., the ANS Forth standard). |
| 123 : | anton | 1.2 | |
| 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 : | pazsan | 1.3 | .SH AUTHORS |
| 128 : | \fBGforth\fR was written by Anton Ertl, Bernd Paysan, Jens Wilke and | ||
| 129 : | others. |
|
CVS Admin Powered by ViewCVS 1.0-dev |
ViewCVS and CVS Help |