Bertrand Delacretaz wrote:
On Monday 18 November 2002 10:41, David Crossley wrote:
. . . I wonder if we can extract some minimal information from javadoc tags and supplement that with an xml fragment in an accompanying file, to build a -manpage.xml . . .
Good idea, I think relying solely on javadoc tags for reference docs would require including too much docs in the code.
+1 for the idea.
Javadocs = reference and contract embedded man docs = description and usage
:-)
I'd probably think of putting the man stuff in the class header, so that it shows in the Javadocs too.
A hack could be to include <div> tags in the html and use them as semantical info to generate Forrest man pages from it (2c)
--
Nicola Ken Barozzi [EMAIL PROTECTED]
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------