| \ documentation source to texi format converter |
\ documentation source to texi format converter |
| |
|
| \ Copyright (C) 1995 Free Software Foundation, Inc. |
\ Copyright (C) 1995,1996,1997,1998 Free Software Foundation, Inc. |
| |
|
| \ This file is part of Gforth. |
\ This file is part of Gforth. |
| |
|
| |
|
| script? [IF] |
script? [IF] |
| warnings off |
warnings off |
| require extend.fs |
|
| require search.fs |
require search.fs |
| |
require extend.fs |
| require glocals.fs |
require glocals.fs |
| require float.fs |
require float.fs |
| require struct.fs |
require struct.fs |
| wordlist constant documentation |
wordlist constant documentation |
| |
|
| struct |
struct |
| 2 cells: field doc-name |
cell% 2* field doc-name |
| 2 cells: field doc-stack-effect |
cell% 2* field doc-stack-effect |
| 2 cells: field doc-wordset |
cell% 2* field doc-wordset |
| 2 cells: field doc-pronounciation |
cell% 2* field doc-pronounciation |
| 2 cells: field doc-description |
cell% 2* field doc-description |
| end-struct doc-entry |
end-struct doc-entry |
| |
|
| create description-buffer 4096 chars allot |
create description-buffer 4096 chars allot |
| repeat then |
repeat then |
| description-buffer tuck - ; |
description-buffer tuck - ; |
| |
|
| |
: skip-prefix ( c-addr1 u1 -- c-addr2 u2 ) |
| |
2dup 2 min s" --" compare 0= |
| |
IF |
| |
[char] - skip [char] - scan 1 /string |
| |
THEN ; |
| |
|
| : replace-_ ( c-addr u -- ) |
: replace-_ ( c-addr u -- ) |
| \ replaces _ with - |
\ replaces _ with - |
| chars bounds |
chars bounds |
| : make-doc ( -- ) |
: make-doc ( -- ) |
| get-current documentation set-current |
get-current documentation set-current |
| create |
create |
| last @ name>string 2, \ name |
last @ name>string skip-prefix 2, \ name |
| [char] ) parse save-mem 2, \ stack-effect |
[char] ) parse save-mem 2, \ stack-effect |
| bl parse-word condition-wordset 2, \ wordset |
bl sword condition-wordset 2, \ wordset |
| bl parse-word dup \ pronounciation |
bl sword dup \ pronounciation |
| if |
if |
| condition-pronounciation |
condition-pronounciation |
| else |
else |
| 2drop last @ name>string |
2drop last @ name>string skip-prefix |
| endif |
endif |
| 2, |
2, |
| get-description save-mem 2, |
get-description save-mem 2, |
| ." @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 ." } " |