[Doc-SIG] Documentation tool

[John Mitchell]

On Thu, 18 Jun 1998, Daniel Larsson wrote:

> Hi everyone,
> 
> I recently spent some time rewriting gendoc from scratch, trying to
> incoprorate some of the ideas I, Robin and some people on this group
> sketched out. I've only just started, so you won't find any working
> code, but I've put up a snapshot at
> 
>   http://starship.skyport.net/crew/danilo/pythondoc/pythondoc.zip
> 
> There's also an HTML page trying to describe what I've done at
> 
>   http://starship.skyport.net/crew/danilo/pythondoc/pythondoc.html
> 
> If you are interested in this, and have some spare time :-), please
> give it a glance and contribute your ideas, suggestions, code, whatever.
> 
> We discussed cross references a couple of months ago [...]


Perhaps this is a silly question, but why not just copy Javadoc's
conventions?  It already handles cross references, embedded HTML, its
easy, and a few zillion people already use it.


- j