Re: SVN type concerns
From: Greg Stein <gstein_at_lyra.org>
Date: 2001-02-23 06:00:07 CET
On Thu, Feb 22, 2001 at 01:34:18PM -0600, Karl Fogel wrote:
This is because you see "int" and wonder about the domain of legal values.
If you see svn_boolean_t or bool or boolean, you *know* the domain is
On the other side of the boolean wall, when you see a function used like
call_some_func ("your mom", "your brother", "don't want to know", 1);
What the hell does that 1 mean? What if I passed 7?
If the last line said TRUE, then I know it is representing a boolean value.
Sure, sure... "documentation saves all". Not when you're reading through
TRUE and FALSE play the same game: *local* documentation for the task at
svn_boolean_t is great for documenting the constraints of the particular
Documentation *elsewhere* can be helpful, but should never be considered the
Note that the use of svn_boolean_t and svn_revnum_t are analogous. Local doc
-- Greg Stein, http://www.lyra.org/Received on Sat Oct 21 14:36:23 2006
This is an archived mail posted to the Subversion Dev mailing list.