[1618] in java-interest
javadoc
daemon@ATHENA.MIT.EDU (John D. Mitchell)
Mon Sep 11 05:10:56 1995
Date: Sun, 10 Sep 1995 23:38:29 -0700
From: "John D. Mitchell" <johnm@emf2-003.emf.net>
To: "Arvind Srinivasan." <asriniva@cat.syr.edu>
Cc: java-interest@java.sun.com
In-Reply-To: <Pine.3.07.9509102055.A25344-9100000@lynx.cat.syr.edu>
Arvind Srinivasan. writes:
> I really like the way javadoc generates 'web-friendly' html documentation
> from the java source files [Lisa Friendly's paper on this subject was
> really informative]. I would like to know if there is a similar tool for
> generating documentation from C++ source files. If not, is anyone working
> on coming up with a 'javadoc-like' tool for C++ ?
javadoc is a sort of a 'literate' programming (LP). Check out Knuth's
_Literate Programming_ book for the story from the source, Fraser &
Hanson's _A Retargetable C Compiler: Design and Implementation_ book for a
wonderful 'real world' example of LP, and comp.programming.literate for
information and discussion on the subject.
Of course this begs the question of why bother with C++... :-)
Hope this helps,
John "I guess that means 'yes'" Mitchell
-
Note to Sun employees: this is an EXTERNAL mailing list!
Info: send 'help' to java-interest-request@java.sun.com
