[Python-Dev] query: docstring formatting in python distutils code
Senthil Kumaran
orsenthil at gmail.com
Wed Jul 7 19:36:58 CEST 2010
On Wed, Jul 7, 2010 at 11:00 PM, Georg Brandl <g.brandl at gmx.net> wrote:
> Agreed. However, reST doesn't need to be less readable if the specific
> inline markup is not used. For example, using `identifier` to refer to a
> function or *var* to refer to a variable (which is already done at quite a
> few places) is very readable IMO. Using ``code`` also isn't bad, considering
> that double quotes are not much different and potentially ambiguous.
What are the specific advantages that you see?
Can it more useful in some cases than the other?
--
Senthil
More information about the Python-Dev
mailing list