version 1.9, 1995/11/07 18:06:36
|
version 1.23, 2000/09/23 15:05:59
|
Line 1
|
Line 1
|
\ 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,1999 Free Software Foundation, Inc. |
|
|
\ This file is part of Gforth. |
\ This file is part of Gforth. |
|
|
Line 26
|
Line 26
|
\ `documentation'. Each word resides there under its own name. |
\ `documentation'. Each word resides there under its own name. |
|
|
script? [IF] |
script? [IF] |
warnings off |
warnings off |
require search-order.fs |
require search.fs |
require glocals.fs |
require extend.fs |
require float.fs |
require glocals.fs |
require struct.fs |
require float.fs |
require debugging.fs |
require struct.fs |
|
require debugs.fs |
[THEN] |
[THEN] |
|
|
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 |
Line 59 create description-buffer 4096 chars all
|
Line 60 create description-buffer 4096 chars all
|
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 |
Line 71 create description-buffer 4096 chars all
|
Line 78 create description-buffer 4096 chars all
|
+loop ; |
+loop ; |
|
|
: condition-stack-effect ( c-addr1 u1 -- c-addr2 u2 ) |
: condition-stack-effect ( c-addr1 u1 -- c-addr2 u2 ) |
save-string 2dup replace-_ ; |
save-mem 2dup replace-_ ; |
|
|
: condition-wordset ( c-addr1 u1 -- c-addr2 u2 ) |
: condition-wordset ( c-addr1 u1 -- c-addr2 u2 ) |
dup 0= |
dup 0= |
if |
if |
2drop s" unknown" |
2drop s" unknown" |
else |
else |
save-string |
save-mem |
endif ; |
endif ; |
|
|
: condition-pronounciation ( c-addr1 u1 -- c-addr2 u2 ) |
: condition-pronounciation ( c-addr1 u1 -- c-addr2 u2 ) |
save-string 2dup replace-_ ; |
save-mem 2dup replace-_ ; |
|
|
: 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-string 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-string 2, |
get-description save-mem 2, |
set-current ; |
set-current ; |
|
|
: emittexi ( c -- ) |
: emittexi ( c -- ) |
Line 123 create description-buffer 4096 chars all
|
Line 130 create description-buffer 4096 chars all
|
." @var{ " r@ doc-stack-effect 2@ type ." } " |
." @var{ " r@ doc-stack-effect 2@ type ." } " |
r@ doc-wordset 2@ type |
r@ doc-wordset 2@ type |
cr |
cr |
|
." @cindex " |
|
." @code{" r@ doc-name 2@ typetexi ." }" |
|
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 ." } " |
Line 135 create description-buffer 4096 chars all
|
Line 152 create description-buffer 4096 chars all
|
r@ print-short |
r@ print-short |
r@ doc-description 2@ dup 0<> |
r@ doc-description 2@ dup 0<> |
if |
if |
." @iftex" cr ." @vskip-3ex" cr ." @end iftex" cr |
\ ." @iftex" cr ." @vskip-0ex" cr ." @end iftex" cr |
type cr cr \ ." @ifinfo" cr ." @*" cr ." @end ifinfo" cr cr |
type cr cr |
|
\ ." @ifinfo" cr ." @*" cr ." @end ifinfo" cr cr |
else |
else |
2drop cr |
2drop cr |
endif |
endif |
Line 217 create docline doclinelength chars allot
|
Line 235 create docline doclinelength chars allot
|
else |
else |
." undocumented: " wordname type cr |
." undocumented: " wordname type cr |
endif ; |
endif ; |
|
|
script? [IF] |
|
require prims2x.fs |
|
s" primitives.b" ' register-doc process-file |
|
require crossdoc.fd |
|
require doc.fd |
|
[THEN] |
|