On Jun 28, 2007, at 8:17 PM, [EMAIL PROTECTED] wrote:
> > > > On 6月28日, 下午5時52分, Alberto Valverde <[EMAIL PROTECTED]> wrote: >> On Jun 27, 2007, at 8:43 PM, Mark Ramm wrote: >> >>> I think we should use pudge for API doc generation, and I want to be >>> fairly hard-core about getting good docstrings, comments and an API >>> overview together so new developers can jump into TG2 development >>> quickly. >> >>> My reasoning for picking Pudge is simple -- it's what's used in >>> pylons, paste, and other sub-projects. >> >> I think it's worth to investigate something else... I've been using >> Pudge for ToscaWidgets' API docs and I think you can blame it for the >> current state of TW's docs :P.... Now seriously, I personally don't >> like it... but it's been too long since I don't use it to give >> compelling reasons... one thing I do remember is that it was *slow*. >> >> I think that an API generator that supported rST output (not only >> input in the docstrings) would be great since it would allow us to >> script it to push the API docs to docs.turbogears.org and >> docs.pythonweb.org. Does something like this exist? >> >> Alberto > > Hi, > > I committed a candidate epydoc API generation doc.ini with a simple > usage readme. > http://trac.turbogears.org/changeset/3180 > > I am new to epydoc but its usage is pretty simple. > . > I found epydoc is possible to use rst as doc format. (check [3180]) Really? Does it support rst as an *output* format (ie: instead of producing html pages, produce rst pages which could later be converted to html)? I think you're referring to rst as an input format, however, if I'm wrong then that'll be very, very nice :) Thanks for the documenattion effort! Alberto --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears Trunk" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/turbogears-trunk?hl=en -~----------~----~----~----~------~----~------~--~---
