> -----Original Message-----
> From: MARTIN PHILIP [mailto:codematters_at_ntlworld.com] On Behalf Of Philip
> Martin
> Sent: woensdag 7 maart 2012 13:42
> To: Greg Stein
> Cc: dev_at_subversion.apache.org
> Subject: Re: svn commit: r1297921 -
> /subversion/trunk/subversion/tests/cmdline/svntest/sandbox.py
>
> Greg Stein <gstein_at_gmail.com> writes:
>
> > Geez. Be smart, Philip. Obviously, that quoted content is dumb. I'm
talking
> > about format. Specifically not following the basic rule of "one line
> > summary. One blank line. Details." Julian's change is missing the blank
> > lines, which many tools parse.
>
> That's what I don't understand. Are we expecting people to use tools to
> parse these docstrings? If we have to repeat default parameters in the
> docstring it it something we can get wrong, if we don't repeat them they
> can't be wrong. What do we gain?
I wouldn't be surprised if some editors (Eclipse? Others) use or will use
this syntax for tooltips, to help users when editing.
Bert
Received on 2012-03-07 13:50:29 CET