Re: TRUE/true/FALSE/false/NULL/null in doc strings [was: svn commit: r34018 - in ...]
Julian Foad wrote:
> On Wed, 2008-11-05 at 05:23 +0100, Neels J. Hofmeyr wrote:
>>> I've updated the doc strings in r34026/r34028/r34029.
>> Thanks! I'd like to change one to say TRUE and FALSE in upper case, because
>> that's what is used with svn_boolean_t. Is it standard practice in the doc
>> strings to write true and false in lower case?
> We haven't standardized. I prefer lower case because I don't see a need
> to make them stand out visually, the reader doesn't need to follow a
> cross-reference to their definitions, and the API user doesn't need to
> use the same defined constants that we use internally. However, the
> majority of us seem to prefer upper case, usually with an "@c" Doxygen
> tag. I like consistency but ... whatever!
Yeah, I could rant on about it. But whatever. :)
Received on 2008-11-05 23:29:39 CET
This is an archived mail posted to the Subversion Dev