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

Re: svn patch --strip-count=N or svn patch --strip=N?

From: C. Michael Pilato <cmpilato_at_collab.net>
Date: Mon, 25 Oct 2010 10:46:52 -0400

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

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.