[Doc-SIG] epydoc reST markup for stdlib docstrings

Georg Brandl g.brandl at gmx.net
Wed Apr 14 23:50:11 CEST 2010


Am 14.04.2010 17:46, schrieb Barry Warsaw:
> On Apr 14, 2010, at 05:37 PM, Michael Foord wrote:
> 
>>Well, perhaps move this discussion to python-dev with the intent of 
>>creating a PEP and asking for BDFL pronouncement? The two contenders 
>>seem to be numpy format and epydoc format. We seem to have a consensus 
>>that adopting a standard for the standard library is a good idea.
>>
>>Once we have settled on a basic format we can thrash out all the 
>>specifics in the PEP.
> 
> I agree.  Right now I've got enough big PEPs on my plate that I'm not willing
> to take on another one right now.  Maybe I've sufficiently
> tempted/goaded/guilted/excited someone else to though. ;)

Yes, I'll write that PEP.  Don't expect it too soon though.

cheers,
Georg



More information about the Doc-SIG mailing list