[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] docstring changes

From: Edmund Wong <ed_at_kdtc.net>
Date: Mon, 27 Apr 2009 12:36:44 +0800

Gavin Baumanis wrote:
> Hi Ed,
>
> In-line with my previous post - I would vote to changing it to your
> (and the original intent) definition of "if and only if".
> I would hate for the community to lose it's ...(I can't come up with
> an appropriate / better word - but for "flavor"),
> But in a comment - as opposed to code - anything that lowers the bar
> - so as to allow more people to understand and contribute, is a
> positive direction to take.

Hi Gavin,

I don't know the status of this patch; but as far as I know with
regards to "iff", I still believe it's a spelling error unless
I read wrong. While I am quite familiar with the 'iff' construct,
I've never seen it at the start of a sentence. Now probably
that stems from my lack of experience with reading docstrings;
still, it is weird to have 'if and only if' at the beginning of
a sentence when an 'if' works just as well.

I even asked gstein over IRC and he agreed with one of the
changes. I didn't ask about the other. Perhaps I falsely
took the liberty of assuming it was under the same 'situation'
(for lack of a better word) so to speak.

Thanks

Edmund

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=1940045
Received on 2009-04-27 06:38:32 CEST

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.