| \ documentation source to texi format converter |
\ documentation source to texi format converter |
| |
|
| \ Copyright (C) 1995,1996,1997,1998 Free Software Foundation, Inc. |
\ Copyright (C) 1995,1996,1997,1998,1999 Free Software Foundation, Inc. |
| |
|
| \ This file is part of Gforth. |
\ This file is part of Gforth. |
| |
|
| |
|
| \ You should have received a copy of the GNU General Public License |
\ You should have received a copy of the GNU General Public License |
| \ along with this program; if not, write to the Free Software |
\ along with this program; if not, write to the Free Software |
| \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
\ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. |
| |
|
| \ documentation source can contain lines in the form `doc-word' and |
\ documentation source can contain lines in the form `doc-word' and |
| \ `short-word'. These are converted to appropriate full or short |
\ `short-word'. These are converted to appropriate full or short |
| description-buffer tuck - ; |
description-buffer tuck - ; |
| |
|
| : skip-prefix ( c-addr1 u1 -- c-addr2 u2 ) |
: skip-prefix ( c-addr1 u1 -- c-addr2 u2 ) |
| 2dup 2 min s" --" compare 0= |
2dup s" --" string-prefix? |
| IF |
IF |
| [char] - skip [char] - scan 1 /string |
[char] - skip [char] - scan 1 /string |
| THEN ; |
THEN ; |
| ." @cindex " |
." @cindex " |
| ." @code{" r@ doc-name 2@ typetexi ." }" |
." @code{" r@ doc-name 2@ typetexi ." }" |
| cr |
cr |
| |
r@ doc-name 2@ drop c@ [char] : <> if |
| |
\ cut out words starting with :, info-lookup cannot handle them |
| |
\ !! deal with : by replacing it here and in info-lookup? |
| |
." @kindex " |
| |
r@ doc-name 2@ typetexi |
| |
cr |
| |
endif |
| ." @format" cr |
." @format" cr |
| ." @code{" r@ doc-name 2@ typetexi ." } " |
." @code{" r@ doc-name 2@ typetexi ." } " |
| ." @i{" r@ doc-stack-effect 2@ type ." } " |
." @i{" r@ doc-stack-effect 2@ type ." } " |
| \ with the prefix addr2 u2 and continuing with a word in the |
\ with the prefix addr2 u2 and continuing with a word in the |
| \ wordlist `documentation'. f is true if xt is executed. |
\ wordlist `documentation'. f is true if xt is executed. |
| >r dup >r |
>r dup >r |
| 3 pick over compare 0= |
3 pick over str= |
| if \ addr2 u2 is a prefix of addr1 u1 |
if \ addr2 u2 is a prefix of addr1 u1 |
| r> /string documentation search-wordlist |
r> /string documentation search-wordlist |
| if \ the rest of addr1 u1 is in documentation |
if \ the rest of addr1 u1 is in documentation |
