Re: [Jython-users] Jython documentation

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

On Mon, 28 May 2001, Finn Bock wrote:
> [Ben Hutchison]
>
> >Well, I am pleased so so many people are interested and willing to
> >contribute to improving the Jython documentation.
> >
> >I think finding a home is the first step, and I would definitely prefer
> >it to be integrated with the jython development site at sourceforge.
>
> Me too.
>
> >...
> >
> >Does anybody want to propose other home candidates, or indicate an
> >preference for one of the above?
>
> Is the SF DocManager usefull for this?
>
>   http://sourceforge.net/docman/?group_id=12867

This may be a good start, but it seems unclear what format limitation
there is on SF.  A limitation to html might not be ideal?  I'm
curious what people think about sticking closer to the latex documentation
Fred Drake details here:

    http://python.sourceforge.net/devel-docs/doc/doc.html

CVS + latex and converting to format-specific output seems a better
investment. How can you do this on SF? Would this mean a separate
'project' for documentation where only the html output is committed to the
jython project?  What are others thoughts?  My cvs+emacs+latex
bias may be another's bane, so speak up.

It seems a quick consesus may be most useful, so I'll cast my
inconsequential vote for what seems most likely to allow latex source...
If authors can have rw to only a /doc subdirectory of Jython's cvs- do
that. Otherwise, this is best served by a unique cvs entry (SF project)
and some 'managed' conversion to html output for posting in the Jython
project.


-Robert