--- gforth/environ.fs 1999/02/03 00:10:19 1.18 +++ gforth/environ.fs 1999/12/03 18:24:23 1.20 @@ -21,14 +21,15 @@ \ wordlist constant environment-wordlist Create environment-wordlist ( -- wid ) \ gforth - \G wid identifies the word list that is searched by environmental + \G @i{wid} identifies the word list that is searched by environmental \G queries. wordlist drop : environment? ( c-addr u -- false / ... true ) \ core environment-query - \G c-addr, u specify the address and length of a string. If the string is - \G not recognised, return a @code{false} flag. Otherwise return a true - \G flag and some (string-specific) information about the queried string. + \G @i{c-addr, u} specify a counted string. If the string is not + \G recognised, return a @code{false} flag. Otherwise return a + \G @code{true} flag and some (string-specific) information about + \G the queried string. environment-wordlist search-wordlist if execute true else @@ -49,7 +50,7 @@ get-order environment-wordlist swap 1+ s \ this should be computed in C as CHAR_BITS/sizeof(char), \ but I don't know any machine with gcc where an au does not have 8 bits. 8 constant ADDRESS-UNIT-BITS ( -- n ) \ environment -\G Size of one address unit, it bits. +\G Size of one address unit, in bits. 1 ADDRESS-UNIT-BITS chars lshift 1- constant MAX-CHAR ( -- u ) \ environment \G Maximum value of any character in the character set @@ -99,8 +100,8 @@ version-string 2constant gforth ( -- c-a [ forthstart 4 cells + ] literal @ cell / ; : floating-stack ( -- n ) \ environment - \G n is non-zero, showing that Gforth maintains a separate - \G floating-point stack of depth n. + \G @var{n} is non-zero, showing that Gforth maintains a separate + \G floating-point stack of depth @var{n}. [ forthstart 5 cells + ] literal @ [IFDEF] float float [ELSE] [ 1 floats ] Literal [THEN] / ;