Re: Extending javadoc for C/C++

  Steve Masticola (masticol@scr.siemens.com) wrote:
  : - The best competitor, Don Knuth's "literate programming" and CWEB
  : (http://www-cs-faculty.Stanford.EDU/~knuth/books.html) have not taken
  : off in widespread practice, for whatever reason.*




kelley@Phys.Ocean.Dal.Ca (Dan Kelley) wrote:
> I agree with the reason given. Knuth's is too complicated.


You might have a look at Norman Ramsey's "noweb":


http://www.cs.virginia.edu/~nr/noweb


It's probably the simplest (it has just 5 commands), most versatile
and widely used literate programming tool. It's programming language
independent (i.e. you can write code in any language - or combination
of languages) and supports such formatting languages as TeX, LaTeX and
HTML. As far as I know, noweb is available for most flavors of UNIX,
MS-DOS/Win32 and MacOS.


Those interested in literate programming may have a look at the moderated
group comp.programming.literate. The FAQ is available at:


ftp://ftp.th-darmstadt.de/programming/literate-programming/help/LitProg-FAQ


--
Paolo Amoroso <amoroso@mclink.it>
--

Return to the comp.compilers page.
Search the comp.compilers archives again.