[BACK]Return to gforth.ds CVS log [TXT] [DIR] Up to [gforth] / gforth / doc

Diff for /gforth/doc/gforth.ds between versions 1.156 and 1.157

version 1.156, 2006/04/08 19:32:42 version 1.157, 2006/05/01 09:34:35
Line 14693  A sequence for adding your initializatio Line 14693  A sequence for adding your initializatio
 ; IS 'cold  ; IS 'cold
 @end example  @end example
   
   After @code{'cold}, Gforth processes the image options
   (@pxref{Invoking Gforth}), and then it performs @code{bootmessage},
   another deferred word.  This normally prints Gforth's startup message
   and does nothing else.
   
 @cindex turnkey image files  @cindex turnkey image files
 @cindex image file, turnkey applications  @cindex image file, turnkey applications
 You can make a turnkey image by letting @code{'cold} execute a word  So, if you want to make a turnkey image (i.e., an image for an
 (your turnkey application) that never returns; instead, it exits Gforth  application instead of an extended Forth system), you can do this in
 via @code{bye} or @code{throw}.  two ways:
   
 You can access the (image-specific) command-line arguments through  @itemize @bullet
 @code{argc}, @code{argv} and @code{arg} (@pxref{OS command line  
 arguments}).  @item
   If you want to do your interpretation of the OS command-line
 If @code{'cold} exits normally, Gforth processes the command-line  arguments, hook into @code{'cold}.  In that case you probably also
 arguments as files to be loaded and strings to be evaluated.  Therefore,  want to build the image with @code{gforthmi --application}
 @code{'cold} should remove the arguments it has used in this case.  (@pxref{gforthmi}) to keep the engine from processing OS command line
   options.  You can then do your own command-line processing with
   @code{next-arg} 
   
   @item
   If you want to have the normal Gforth processing of OS command-line
   arguments, hook into @code{bootmessage}.
   
   @end itemize
   
   In either case, you probably do not want the word that you execute in
   these hooks to exit normally, but use @code{bye} or @code{throw}.
   Otherwise the Gforth startup process would continue and eventually
   present the Forth command line to the user.
   
 doc-'cold  doc-'cold
   doc-bootmessage
   
 @c ******************************************************************  @c ******************************************************************
 @node Engine, Cross Compiler, Image Files, Top  @node Engine, Cross Compiler, Image Files, Top
Removed from v.1.156  
changed lines
  Added in v.1.157

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>