Marco d'Itri <md@Linux.IT> wrote:
> Wrong. When using doxygen and similar programs, source and documentation
> are in the same file but they are not the same bits.
You are wrong. There are systems like Mole for lisps which
transform the source to render part of the documentation.
http://www196.pair.com/lisovsky/download/mole/mole-doc.html
I'd be surprised if none of doxygen and similar systems parse
non-commentary source.
There are also other interesting border cases like GNU hello and
postscript. I hope these can be catalogued in the FAQ under a
question "What are awkward examples for dividing documentation
and programs?" or similar, along with Postscript and others.
--
MJR/slef
My Opinion Only: see http://people.debian.org/~mjr/
Please follow http://www.uk.debian.org/MailingLists/#codeofconduct