Академический Документы
Профессиональный Документы
Культура Документы
The file glosgen.str implements a very basic form of the glossary generator
I like to be used as a standard tool with ANSFIG. BTW, it is written in
standard (mostly standard?) ANS Forth, so it should be usable on many
systems. You must first fix a small bug in WRITE-FILE (it returns bytes
written and io result while it must return only io result 15/7/93) if you
want to use it on ANSFIG. This same bug affects WRITE-LINE too. Further
CREATE-FILE creates (with me on Linux) a file with no permissions at all.
Is this intended behaviour, or a bug?
The file glosgen.str is currently the only file with glossary comments in
it. The file glosgen.glo is the glossary file of it. It was created by the
following commands:
newglos
makeglos glosgen.str
writeglos glosgen.glo
Possible changes
- Add several types of glossary comments, general and more technical
comments. (\G and \T) Words of general interest get \G comments and
words that are used only internally have \T comments. Then it is possible
to generate a basic glossary for general users and a more technical
glossary for programmers. Of course the source itself is the most
technical description.
- If Forth gets a VIEW file system a la F83 or F-PC, it would be possible
to scan the words of an already compiled word list and find the defining
line in the source file this way. (then the name is always right).
Lennart Benschop