From: George H. <geo...@us...> - 2005-12-22 11:02:58
|
Update of /cvsroot/win32forth/win32forth/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv10424/win32forth/doc Modified Files: p-index.htm p-module.htm Log Message: gah: Added documentation for dexh to task.f and minor spelling correction Index: p-module.htm =================================================================== RCS file: /cvsroot/win32forth/win32forth/doc/p-module.htm,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** p-module.htm 14 Dec 2005 13:49:30 -0000 1.1 --- p-module.htm 22 Dec 2005 11:02:28 -0000 1.2 *************** *** 6,10 **** <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <title> ! W32F modules</title><style><!-- h1 { font-family: Tahoma; font-size: 24pt; font-weight: bold } h2 { font-family: Tahoma; font-size: 18pt; font-weight: bold } --> --- 6,10 ---- <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <title> ! W32F module</title><style><!-- h1 { font-family: Tahoma; font-size: 24pt; font-weight: bold } h2 { font-family: Tahoma; font-size: 18pt; font-weight: bold } --> *************** *** 16,26 **** <img border="0" src="FORTHPRO.gif" width="32" height="32"> Win32Forth</h1> ! <hr /> ! <h1> ! Using the Module Wordset ! </h1> ! <hr /> ! <p> ! Win32Forth implements the ANSI search-order wordset and extensions as well as it's own set of words for constructing modules. Since the module wordset works by manipulating the search order then care should be taken when using the module wordset and search order --- 16,21 ---- <img border="0" src="FORTHPRO.gif" width="32" height="32"> Win32Forth</h1> ! <hr /><h1>Using the Module Wordset ! </h1><hr /><p>Win32Forth implements the ANSI search-order wordset and extensions as well as it's own set of words for constructing modules. Since the module wordset works by manipulating the search order then care should be taken when using the module wordset and search order *************** *** 31,83 **** EXTERNAL and MODULE should not be executed within a CLASS or OBJECT although they can be used before and after the CLASS or OBJECT. ! </p> ! <h2> ! Error Handling ! </h2> ! <p> ! If an uncaught error occurs while building a module then the default error handler resets the state of the module wordset as though the module had been finished correctly. ! </p> ! <h2> ! Glossary ! </h2> ! <pre><b> ! : (PRIVATE) ( xt-of-voc -- ) ! </b></pre> ! <p> ! Set the vocabulary for internal definitions for the next module to be built. This is a non-parsing version of the word PRIVATE. ! </p> ! <pre><b> ! : PRIVATE ( -<voc>- ) ! </b></pre> ! <p> ! Set the vocabulary for internal definitions for the next module to be built. This is a parsing version of the word (PRIVATE). ! </p> ! <pre><b> ! : INTERNAL ( -- ) ! </b></pre> ! <p> ! If a module hasn't yet been started or the internal vocabulary isn't the context vocabulary add the internal vocabulary to the search order and save the current vocabulary as the external vocabulary, then make the current vocabulary the internal vocabulary. If a module is already being built then make the current vocabulary the internal vocabulary. ! </p> ! <pre><b> ! : EXTERNAL ( -- ) ! </b></pre> ! <p> ! Make the external vocabulary the current vocabulary. ! </p> ! <pre><b> ! : MODULE ( -- ) ! </b></pre> ! <p> ! Complete the module by making the external vocabulary the current vocabulary, removing the internal vocabulary from the search order if it's the context vocabulary and resetting the internal vocabulary to hidden. ! </p> ! <hr><p>Document $Id$</p> </body></html> --- 26,51 ---- EXTERNAL and MODULE should not be executed within a CLASS or OBJECT although they can be used before and after the CLASS or OBJECT. ! </p><h2>Error Handling ! </h2><p>If an uncaught error occurs while building a module then the default error handler resets the state of the module wordset as though the module had been finished correctly. ! </p><h2>Glossary ! </h2><pre><b><a name="0">: (PRIVATE) ( xt-of-voc -- ) ! </a></b></pre><p>Set the vocabulary for internal definitions for the next module to be built. This is a non-parsing version of the word PRIVATE. ! </p><pre><b><a name="0">: PRIVATE ( -<voc>- ) ! </a></b></pre><p>Set the vocabulary for internal definitions for the next module to be built. This is a parsing version of the word (PRIVATE). ! </p><pre><b><a name="0">: INTERNAL ( -- ) ! </a></b></pre><p>If a module hasn't yet been started or the internal vocabulary isn't the context vocabulary add the internal vocabulary to the search order and save the current vocabulary as the external vocabulary, then make the current vocabulary the internal vocabulary. If a module is already being built then make the current vocabulary the internal vocabulary. ! </p><pre><b><a name="0">: EXTERNAL ( -- ) ! </a></b></pre><p>Make the external vocabulary the current vocabulary. ! </p><pre><b><a name="0">: MODULE ( -- ) ! </a></b></pre><p>Complete the module by making the external vocabulary the current vocabulary, removing the internal vocabulary from the search order if it's the context vocabulary and resetting the internal vocabulary to hidden. ! </p><hr><p>Document $Id$</p> </body></html> Index: p-index.htm =================================================================== RCS file: /cvsroot/win32forth/win32forth/doc/p-index.htm,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** p-index.htm 20 Dec 2005 18:10:15 -0000 1.6 --- p-index.htm 22 Dec 2005 11:02:28 -0000 1.7 *************** *** 137,140 **** --- 137,141 ---- <li><a href="p-classes.htm">Win32Forth Classes</a></li> <li><a href="p-module.htm">Using the Module Wordset</a></li> + <li><a href="p-task.htm">Using the Task Wordset</a></li> <li><a href="p-random.htm">The Random Number Generator</a></li> <li><a href="p-switch.htm">Using Switches</a></li> |