> On Sun, 2003-03-30 at 10:09, Tom von Schwerdtner wrote: >> We could also >> > consider it for Webware at some future date. I have a couple >> reservations about it though: >> > (1) I haven't seen how the styles look in a graphical browser or >> printout, (2) Twisted Lore currently depends on a homegrown XML >> parser in Twisted, which I'm reluctant to depend on. >> >> Any more thoughts on this now that PyCon is done with? > > I can't speak for Mike, but I really don't like HTML markup in > docstrings.
I was thinking about Lore for separate manuals, not for docstrings. Text or ReST makes more sense for docstrings. The Cheetah manuals are curerntly in LaTeX, which is a pain to maintain, a greater pain to customize, and an even greater pain to recruit others to contribute to. We've stuck with LaTeX because it has several output formats, we can use the Python stylesheets, and DocBook wouldn't really gain us anything. But alternatives are worth considering. Regarding the Webware docs, changing from HTML would have to be a decision by the Webware team since I don't speak for them. I'm currently writing my stuff in text because that's easier for me, and will convert it to HTML or whatever later. I won't be able to comment further until after I get home sometime in mid April and try out Lore and Twisted and the other stuff I learned about in the conference. But I am writing an article about the conference, which will be on the Linux Journal site as soon as it's done. ------------------------------------------------------- This SF.net email is sponsored by: The Definitive IT and Networking Event. Be There! NetWorld+Interop Las Vegas 2003 -- Register today! http://ads.sourceforge.net/cgi-bin/redirect.pl?keyn0001en _______________________________________________ Webware-discuss mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/webware-discuss
