[Doc-SIG] Documentation tool
John Mitchell
johnm@magnet.com
Thu, 18 Jun 1998 14:10:24 -0400 (EDT)
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