Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GForth(1)		    General Commands Manual		     GForth(1)

NAME
       gforth, gforth-fast, gforthmi - a fast and portable Forth system

SYNOPSIS
       gforth  [initialization	options]  [image-specific options] gforth-fast
       [initialization options]	[image-specific	options]

       gforthmi	filename [initialization options] [image-specific options]

DESCRIPTION
       GForth is a fast	and portable implementation of the  Forth  programming
       language. For details read the manual.

ENVIRONMENT VARIABLES
       GFORTHPATH contains the search path for source and image	files.

       GFORTHD	gives  the gforth executable used by gforthmi for creating the
       base images. It should be a double indirect threaded system.   Default:
       gforth-ditc.

       GFORTH  gives  the gforth executable used by gforthmi for computing the
       relocatable image from the base images. Default:	gforth.

       GFORTHHIST gives	the location of	the history file  used	by  gforth  to
       allow  command-line  recall. Default: $HOME. (The history file is named
       .gforth-history).

EXAMPLES
       gforth

       starts the system and goes into interactive mode.

       gforth file1 file2 -e bye

       loads and interprets the	files file1 and	file2, then exits.

       gforth-fast

       is the same as gforth, except that it does not support  accurate	 back-
       traces  for  signals, and is faster by up to a factor of	2.  Use	it for
       debugged, performance-critical programs such as benchmarks.

       gforthmi	asm.fi -m 1M asm.fs

       creates an image	asm.fi that has	a default dictionary size of  1MB  and
       has the file asm.fs loaded.

OPTIONS
       --help
       Lists the available options, including some not described here (see
	      also the manual).

       --image-file file
       Loads the Forth image
	      file instead of the default gforth.fi.

       --path path
       Uses   path  for	 searching  the	image file and Forth source code files
	      instead of the default in	the environment	variable GFORTHPATH or
	      the    path    specified	 at   installation   time   (typically
	      /usr/local/lib/gforth:.. A path is given as a :-separated	list.

       --dictionary-size size
       Allocate
	      size space for the Forth dictionary space	instead	of  using  the
	      default specified	in the image (typically	256K). The size	speci-
	      fication consists	of an integer and a unit (e.g.,	4M).  The unit
	      can be one of b (bytes), e (element size,	in this	case Cells), k
	      (kilobytes), and M (Megabytes). If no unit is  specified,	 e  is
	      used.

       --data-stack-size size
       Allocate
	      size space for the data stack instead of using the default spec-
	      ified in the image (typically 16K).

       --return-stack-size size
       Allocate
	      size space for the return	stack instead  of  using  the  default
	      specified	in the image (typically	16K).

       --fp-stack-size size
       Allocate
	      size  space  for	the  floating point stack instead of using the
	      default specified	in the image (typically	16K). In this case the
	      unit specifier e refers to floating point	numbers.

       --locals-stack-size size
       Allocate
	      size  space  for	the  locals stack instead of using the default
	      specified	in the image (typically	16K).

       --evaluate forth
       Evaluates the
	      forth code. This option takes only one argument; if you want  to
	      evaluate more Forth words, you have to quote them	or use several
	      -es.  To exit after processing  the  command  line  (instead  of
	      entering	interactive  mode)  append -e bye to the command line.
	      This is an image-specific	option of the default image.

FILES
       .../gforth.fi  default Forth image
       *.fi	      Forth loadable image
       *.fs	      Forth source (sequential)
       *.fb	      Forth source (block)
       *.fd	      generated	with makedoc.fs
       *.i	      C	include	files
       *.ds	      documentation source
       *TAGS	      etags files

SEE ALSO
       The Gforth manual - available in	hypertext (Info, HTML)	and  printable
       (TeX, PS, ASCII)	forms.

       The ANSI	document X3.215-1994 (i.e., the	ANS Forth standard).

       More information	on Gforth (e.g., pointers to new versions, to the man-
       ual on the WWW  and  to	papers	about  Gforth)	is  available  through
       http://www.complang.tuwien.ac.at/projects/forth.html.

AUTHORS
       Gforth was written by Anton Ertl, Bernd Paysan, Jens Wilke and others.

				April 14, 1999			     GForth(1)

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT VARIABLES | EXAMPLES | OPTIONS | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gforth&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help