| \ create a documentation file |
\ create a documentation file |
| |
|
| \ Copyright (C) 1995 Free Software Foundation, Inc. |
\ Copyright (C) 1995,1999,2000,2003,2004,2007 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. |
| |
|
| |
|
| \ the stack effect of loading this file is: ( addr u -- ) |
\ the stack effect of loading this file is: ( addr u -- ) |
| source >in ! drop ; immediate |
source >in ! drop ; immediate |
| |
|
| : put-doc-entry ( -- ) |
: put-doc-entry ( -- ) |
| locals-list @ 0= \ not in a colon def, i.e., not a local name |
dpp @ normal-dp = \ not defining locals |
| last @ 0<> and \ not an anonymous (i.e. noname) header |
latest 0<> and \ not an anonymous (i.e. noname) header |
| if |
if |
| s" " >fileCR |
s" " >fileCR |
| s" make-doc " >file |
s" make-doc " >file |
| >in @ >r |
>in @ >r |
| [char] ( parse 2drop |
parse-name 2dup s" (" str= if |
| [char] ) parse |
2drop ') parse |
| |
else |
| |
2dup s" {" str= if |
| |
2drop '} parse |
| |
else \ no stack comment or locals |
| |
2drop |
| |
r@ >in ! \ restore "\" |
| |
s" unknown " \ default stack comment |
| |
endif |
| |
endif |
| [char] \ parse 2drop |
[char] \ parse 2drop |
| >in @ |
>in @ |
| bl word dup c@ |
bl word dup c@ |
| ELSE |
ELSE |
| drop >in ! |
drop >in ! |
| THEN |
THEN |
| last @ name>string >file |
latest name>string >file |
| |
s" " >file |
| >file |
>file |
| s" )" >file |
s" )" >file |
| POSTPONE \g |
POSTPONE \g |
