On Sun, 7 Feb 2010, Taco Hoekwater wrote:

Here is the list of serious candidates (in my current opinion):

* Cweb    http://www-cs-faculty.stanford.edu/~knuth/cweb.html
* Doxygen http://www.stack.nl/~dimitri/doxygen/
* Noweb   http://www.cs.tufts.edu/~nr/noweb/

Hi Taco,

from my point of view Cweb/Noweb generate C code (as do flex and bison),
whereas Doxygen uses (annotated) C code to generate documentation. Thus they
fall into quite different categories.

Cweb is special because it is built as part of TL, but otherwise probably
much like Noweb. Flex/bison are special because they are directly supported
by Automake. Cweb is supported in the TL build system via a shell script
that handles all issues for parallel make, but still needs special build
rules -- Noweb could be handled in a similar way.

From the build system side, I'd think normal users (i.e., people building
TL or just luaTeX) should not be required to have either Noweb or Doxygen,
as they are not required to have Autoconf, Automake, Flex, or Bison.

The situation is, of course, quite different for developers/maintainers,
i.e., for everyone modifying the ultimate source files.

Regards
Peter Breitenlohner <[email protected]>
_______________________________________________
dev-luatex mailing list
[email protected]
http://www.ntg.nl/mailman/listinfo/dev-luatex

Reply via email to