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

Re: Mismatch docs/code. WAS: RE: svn commit: rev 1774 - trunk/subversion/include trunk/subversion/libsvn_delta

From: Kirby C. Bohling <kbohling_at_birddog.com>
Date: 2002-04-25 18:44:16 CEST

Sander Striker wrote:
>
> Because I missed a rename in the code before committing we now have
> _end in the .h file and _length in the .c file. I'm going to let them
> match up again, but would like some feedback to what is preferred.
>
> Do we want ranges to be represented by:
>
> START - END e.g. 0 - 3 translates to [0, 1, 2]
>
> or:
>
> START, LENGTH e.g. 3, 3 means [3, 4, 5]
>
>
> Thoughts?
>
> Sander

        I have always thought START - END is much more natural and easy.
However, it appears every library in exsistance seems to disagree with
me. Every time I have ever seen a "substring" like operation they all
use "start, length" never "start - end" (now that I say that 10 people
will reply with counter examples).

        I have yet to see a common C or C++ library that represents it the START
- END way. Of course using this argument we never will. In the end it
ends up making them work like memcpy(), (the third param is a number of
bytes, not the place to stop). which makes it easier to remember.
That's my 2 cents.

                Kirby

>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
> For additional commands, e-mail: dev-help@subversion.tigris.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Apr 25 18:48:39 2002

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.