Hi Hannu,

> I have written some forth code and I've forgot what it does. I got
> this idea of generating documentation and started to google a bit.
> AFAIK only amfort has autogenerated documentation.

Not at all. You may look at the linux kernel sources as well ;)
Mixing code and its documentation is is a very old idea. e.g.
TeX is written in a file format that is used to generate the
source code for the compiler and the documentation (for TeX
itself).

> I'm not familiar with perl and I just had quick look for makewords
> script. I got understanding that it is heavily amforth specific.

Absolutly. When I started amforth, doxygen and friends are not
usable for assembly sources. Furthermore I wanted a tool that
could generate forth-like hypertext'ed html from the assembler
sources. _That_ is indeed something no other tool I know of can do.

> And the result would be doxygen support for Forth.

You may want to look at gforth. They use something forth-like
to generate the docs. And you may want to read
the book from Stephen Pelc: www.mpeforth.com/arena/ProgramForth.pdf

Matthias

------------------------------------------------------------------------------
Cloud Services Checklist: Pricing and Packaging Optimization
This white paper is intended to serve as a reference, checklist and point of 
discussion for anyone considering optimizing the pricing and packaging model 
of a cloud services business. Read Now!
http://www.accelacomm.com/jaw/sfnl/114/51491232/
_______________________________________________
Amforth-devel mailing list for http://amforth.sf.net/
Amforth-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/amforth-devel

Reply via email to