--- gforth/ds2texi.fs 1995/10/07 17:38:11 1.7 +++ gforth/ds2texi.fs 1996/08/21 14:58:38 1.10 @@ -1,5 +1,23 @@ \ documentation source to texi format converter +\ Copyright (C) 1995 Free Software Foundation, Inc. + +\ This file is part of Gforth. + +\ Gforth is free software; you can redistribute it and/or +\ modify it under the terms of the GNU General Public License +\ as published by the Free Software Foundation; either version 2 +\ of the License, or (at your option) any later version. + +\ This program is distributed in the hope that it will be useful, +\ but WITHOUT ANY WARRANTY; without even the implied warranty of +\ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +\ GNU General Public License for more details. + +\ You should have received a copy of the GNU General Public License +\ along with this program; if not, write to the Free Software +\ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + \ documentation source can contain lines in the form `doc-word' and \ `short-word'. These are converted to appropriate full or short \ (without the description) glossary entries for word. @@ -10,6 +28,7 @@ script? [IF] warnings off require search-order.fs +require glocals.fs require float.fs require struct.fs require debugging.fs @@ -40,20 +59,45 @@ create description-buffer 4096 chars all repeat then description-buffer tuck - ; +: replace-_ ( c-addr u -- ) + \ replaces _ with - + chars bounds + +DO + i c@ [char] _ = + if + [char] - i c! + endif + 1 chars + +loop ; + +: condition-stack-effect ( c-addr1 u1 -- c-addr2 u2 ) + save-mem 2dup replace-_ ; + +: condition-wordset ( c-addr1 u1 -- c-addr2 u2 ) + dup 0= + if + 2drop s" unknown" + else + save-mem + endif ; + +: condition-pronounciation ( c-addr1 u1 -- c-addr2 u2 ) + save-mem 2dup replace-_ ; + : make-doc ( -- ) get-current documentation set-current create last @ name>string 2, \ name - [char] ) parse save-string 2, \ stack-effect - bl parse-word save-string 2, \ wordset + [char] ) parse save-mem 2, \ stack-effect + bl parse-word condition-wordset 2, \ wordset bl parse-word dup \ pronounciation if - save-string + condition-pronounciation else 2drop last @ name>string endif 2, - get-description save-string 2, + get-description save-mem 2, set-current ; : emittexi ( c -- ) @@ -139,10 +183,44 @@ create docline doclinelength chars allot repeat drop rdrop ; +: compare-ci ( addr1 u1 addr2 u2 -- n ) + \ case insensitive string compare + 2 pick swap - + ?dup-0=-if + capscomp + else + nip nip nip + 0< + if + -1 + else + 1 + endif + endif ; + +: answord ( "name wordset pronounciation" -- ) + \ check the documentaion of an ans word + name { D: wordname } + name { D: wordset } + name { D: pronounciation } + wordname documentation search-wordlist + if + execute { doc } + wordset doc doc-wordset 2@ compare-ci + if + ." wordset: " wordname type ." : '" doc doc-wordset 2@ type ." ' instead of '" wordset type ." '" cr + endif + pronounciation doc doc-pronounciation 2@ compare-ci + if + ." pronounciation: " wordname type ." : '" doc doc-pronounciation 2@ type ." ' instead of '" pronounciation type ." '" cr + endif + else + ." undocumented: " wordname type cr + endif ; + script? [IF] require prims2x.fs s" primitives.b" ' register-doc process-file -require doc.fd require crossdoc.fd -s" gforth.ds" r/o open-file throw ds2texi bye +require doc.fd [THEN]