[Webware-devel] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Michael Engelhart
Hi - I'm new to this list and while I just barely have scratched the surface of Webware (and python for that matter), I would be glad to take files in XML format and generate the HTML documentation using XSLT. Unfortunately I've had a lot of problems generating output with the Python XSL proc

Re: [Webware-devel] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Ray Leyva
Hi, I talked a few months back about a book, but it never seemed to get any traction. I'm big on Xml / Xsl, and am very willing to lend myself to a project like this. With Python you want the gnome / libxml2 & libxslt python bindings. They are fantastic. I also recommend using the Gentoo sty

[Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 07:18, Stefan Schwarzer wrote: > > Actually, I guess my real issue is that inline documentation doesn't > > distinguish between user interfaces and internal interfaces -- > > particularly when those internal interfaces are not entirely internal, > > like methods that you may w

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 09:06, Aaron Held wrote: > >>Anyway, I've been writing lots of documentation lately, and I've been > >>using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > >>worked pretty well for me -- the output looks decent, but more > >>importantly it's comfortable t

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Mike Warren
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Ian Bicking <[EMAIL PROTECTED]> writes: > I might be able to get over my annoyance with XML if I look deeper > into Emacs -- I'm sure there's something in there to make it more > pleasant (maybe abbrev...) Yes, there's sgml-mode. Supplied with a DTD,

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Aaron Held
Anyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, but more importantly it's comfortable to write. Keeping the documentation up-to-date is the most esse

[Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Stefan Schwarzer
Hi Ian On 24 Oct 2002, Ian Bicking wrote: > Anyway, I've been writing lots of documentation lately, and I've been > using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > worked pretty well for me -- the output looks decent, but more > importantly it's comfortable to write. Ke