On 10/25/2010 10:13 AM, Stefan Sperling wrote:
>>> The --strip-count name matches the variable name in the code.
>>
>> Er... This is a non-reason. :-)
>
> It's not a non-reason because there is no good reason for not naming
> things in a consistent way.
>
> Consistency between the API and the CLI interface is good.
> It's not terribly important, but consistency in naming things does make
> a difference if you try to follow a code path from the very top (CLI
> client) to the very bottom of Subversion (e.g. libsvn_wc).
> Any inconsistency your encounter during that journey presents a mental
> hoop you need to jump through in order to continue the journey.
Preaching to the choir, brother. You'll never find a more vocal supporter
of consistency than ol' C-Mike.
But target audience matters, too. There are millions of Subversion users.
There are quite a bit fewer direct consumers of Subversion's API. If
consistency is achievable while appealing to both audiences, great -- but
let it be the multi-millions who get first pick of the name that works best,
not the perhaps only hundreds who work with the API. We can always rename
an API variable. :-)
--
C. Michael Pilato <cmpilato_at_collab.net>
CollabNet <> www.collab.net <> Distributed Development On Demand
Received on 2010-10-25 16:47:34 CEST