Re: [Python-Dev] reST limitations? (was Re: status of development documentation)

2005-12-23 Thread Fredrik Lundh
Martin Blais wrote: So, definitions of functions, classes, and other structured stuff would just use fields under a directive, and references to those definitions would just be reST links. So you end up with a document with a bunch of custom directives, like:: .. python-class:: MyClass

[Python-Dev] reST limitations? (was Re: status of development documentation)

2005-12-22 Thread Phillip J. Eby
At 04:08 PM 12/22/2005 -0500, Martin Blais wrote: ReST does an amazing job of inferring generic document structures from text, but for documenting source code, you really want to be able to say This is a function, this is an optional argument, etc. ReST does not provide this kind of

Re: [Python-Dev] reST limitations? (was Re: status of development documentation)

2005-12-22 Thread Martin Blais
On 12/22/05, Phillip J. Eby [EMAIL PROTECTED] wrote: At 04:08 PM 12/22/2005 -0500, Martin Blais wrote: ReST does an amazing job of inferring generic document structures from text, but for documenting source code, you really want to be able to say This is a function, this is an optional