[Buildbot-devel] API documentation

[Jean-Paul Calderone]

On Thu, 30 Jul 2009 13:43:11 -0400, "Dustin J. Mitchell" <dustin at zmanda.com> wrote:
>On Thu, Jul 30, 2009 at 1:15 PM, Marcus Lindblom<macke at yar.nu> wrote:
>> Not sure. Dustin/Brian should know more about that (ping! ;). Since
>> we're running the metabuildbot on buildbot.net, building and publishing
>> API docs ought to be doable.
>
>We've looked into this a few times.  The problem is that epydoc
>installs require basically an entire desktop environment (X, LaTeX,
>and a whole bunch of other cruft that doesn't belong on a linode
>slice).  Also, the buildbot epydoc script requires epydoc 2, and only
>3 is available.
>
>So if someone wants to take this on and get it working (I'm told there
>are other tools besides epydoc that can convert docstrings to html
>pages), let me know.

pydoctor can, and does a good job, and doesn't have an X dependency.

Jean-Paul