[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: Peter N. Lundblad <peter_at_famlundblad.se>
Date: 2005-02-27 22:35:24 CET

On Sat, 26 Feb 2005, 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

Note that you can read aobut our deprecation policy in HACKING. You're
only supposed to use the latest version of a function available (if you
don't need to be compatible with a particular version of the libs.)

> they're supposed to do anymore. Always assume the documentation is wrong.

Well, comments get out-dated over time, but if the API documentation is
wrong, it should be fixed.

Regards,
//Peter

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sun Feb 27 22:34:17 2005

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