On Jan 26, 2005, at 11:10 AM, Barry Warsaw wrote:
On Wed, 2005-01-26 at 06:39, Stephen J. Turnbull wrote:
I have to agree. Doesn't it make more sense to move to something like reStructuredText if you need to produce somewhat nice-looking web or printed documents without much effort?
I think the doc source doesn't make much of a difference, and I like the
mkhowto scripts that come with Python. They can easily take latex and
produce HTML, PDF, and plaintext. I don't think the reST tools are
quite there yet.
As probably one of few people here who's spent any time using the mkhowto scripts, I'm with Barry. They're pretty decent, make fairly nice output in several different formats, and are easily available to people who already have python set up. AND I think since we already have a decent chunk of documentation in this formats, it makes sense to keep our documentation in this format rather than having a mess of other tools about.
Related: I get mail from people who've printed out the mailman documents, so the more nicely formatted stuff is getting used... and appreciated!
As long as the plan is to have some nice plaintext documents in the root when we do the actual release, this seems good to me.
Terri
PS - Tokio: I've got a pile of patches for the in-line documentation of the stuff in bin/ that I need to double-check and submit. Will there be any problem if I check them in now? I can wait if it makes your life easier.
_______________________________________________ Mailman-Developers mailing list Mailman-Developers@python.org http://mail.python.org/mailman/listinfo/mailman-developers Unsubscribe: http://mail.python.org/mailman/options/mailman-developers/archive%40jab.org
