Re: [Jython-dev] Jython documentation

[Robert W. B. <rb...@di...>]

On Thu, 7 Jun 2001, Samuele Pedroni wrote:
> Hi.
>
> >
> > -> I'm not convinced there's a better, stable, cross-platform
> > -> answer out there today, but probably *soon* there will be
> > -> a stable enough xml-based system (that can even generate
> > -> the old latex if needs be).  There are such systems today,
> > -> but I don't think they fit all of the criteria one might
> > -> want: ()
> >
> > What about DocBook?  I've heard good things about it, although I've not
> > gotten around to using it personally.
> >
> If I remember well, using DocBook is an idea that is haunting around also
> for CPython doc but refrained for the moment because of
> stable, usable, cross-platform, free issues for tools.

Mats suggestion motivated me to dive into docbook this afternoon. I had
terrific luck, especially with Cees de Groot's Python
package "SGML-lite"- http://sourceforge.net/projects/sgmltools-lite/

There's also quite a few editors and editor modes that should accomodate
most people.

> For the moment, in order to get started and gather things the wiki should
> be ok.

Agreed. Spread the word, "Go fill the wiki!"

When some sizable content collects in the wiki, I'll plug it into docbook
and see what people think.

> I think that asking directly on doc-sig list or to Fred Drake on the format,
> tools issue in relation with CPython doc and its future would be very useful.

Good idea.  Will do

> A marginal note: latex, tex exists and works under win but for the other
> tools I don't know either.
>
> regards, Samuele Pedroni.


rb