On Feb 19, 4:16 pm, [EMAIL PROTECTED] wrote: > On Feb 19, 4:12 pm, Preston Landers <[EMAIL PROTECTED]> wrote: > > > On Feb 16, 1:56 am, John Nagle <[EMAIL PROTECTED]> wrote: > > > > Preston Landers wrote: > > > > Hey guys and gals. What are all the cool kids using these days to > > > > document their code? > > > > HTML. Text-only docs are so last-cen. > > > My sarcasometer is broken today... are you being serious? > > man serious
As opposed to woman serious? Are people really writing pure HTML snippets in docstrings to document each module/class/method? For anything other than a toy project? One of the main reasons I'm considering moving to epydoc + reST is precisely because it's very un-HTML. Mind you I want to be able to produce HTML format docs from the source, but I don't want to actually *put* HTML anywhere near my precious sources. -- http://mail.python.org/mailman/listinfo/python-list
