doc generator

[radix]

On Fri, 09 Nov 2001 16:48:24 -0500, Fernando Pérez wrote:

>> Itamar Trauring and Jurgen Hermann (sorry Jurgen, no umlaut key) are
>> working on a "competitor" of HappyDoc's called Teud. It uses XSLT and
>> lookes much better (IMO) than HappyDoc.
>> 
>> http://twistedmatrix.com/users/jh.twistd/python/moin.cgi/TeudProject
> 
> Pardon the ignorance, but in which ways does this add to pydoc's
> functionality? I went to their website and looked at the example page,
> and the output is the exact same content I get from running pydoc -g,
> just with uglier formatting and poor nesting structure. Since pydoc is
> already part of Python officially, and offers a very powerful object
> introspection infrastructure (via the inspect module), I'd like to
> understand what the contribution of this project truly is.
> 
> I'm honestly not bashing its authors, I'm sure they've put a lot of work
> into it. I'd just like to clarify in what areas it adds to something
> that's already built into python, and which does a very good job.
> 
> Cheers,

You'll have to pardon _my_ ignorance, because the only thing that I know
about Teud is "It looks better than HappyDoc". :) I'm generally not
interested in documentation generators, and haven't touched PyDoc -- I
just know the authors, and throught it'd be nice of me to plug their project
;)

Anyway, that page is on a wiki -- I'd recommend you ask that question
there, and I'm sure one of the authors will respond to it. (If you're not
familiar with wikis, see
http://twistedmatrix.com/users/jh.twistd/python/moin.cgi/WikiWikiWebFaq)

-- 
<glyph> It's just like a method call, but ON FIRE AND UPSIDE DOWN!!!
--
                              Chris Armstrong
                      <<< radix at twistedmatrix.com >>>
              http://twistedmatrix.com/users/carmstro.twistd/