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

Re: new functions in 1.2

From: Brian W. Fitzpatrick <fitz_at_collab.net>
Date: 2005-02-26 17:19:25 CET

On Feb 26, 2005, at 6:38 AM, Holger Hoffstaette wrote:

> On Sat, 26 Feb 2005 11:04:56 +0100, SteveKing wrote:
>
>> I've just browsed through the API's which will be introduced in 1.2
>> and I
>> don't quite understand the docs of some of them.
>>
>> svn_client_status2()
>> --------------------
>> the doc for svn_client_status() says: "Similar to
>> svn_client_status2(),
>> but with the ignore_externals parameter always set to TRUE."
>>
>> Shouldn't that be "FALSE"? I mean an 'svn st' now always shows the
>> externals, so the externals are _not_ ignored now?
>
> I cannot answer that particular question but would suggest that the
> functions be renamed so that their meaning becomes clear. Otherwise in
> 3
> years there'll be svn_foo_bar(1|2|3|4|5) and nobody will remember what
> they're supposed to do anymore. Always assume the documentation is
> wrong.

Not true. Once Subversion goes to 2.0, svn_foo_bar2 functions will be
renamed to fvn_foo_bar, and the old (deprecated) functions will go away

While we may very well wind up with svn_foo_bar_4 (although there's a
slight chance), it's not something that we'll live with forever.

-Fitz

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Feb 26 17:20:44 2005

This is an archived mail posted to the Subversion Dev mailing list.