On 12/8/06, Hyrum K. Wright <hyrum_wright@mail.utexas.edu> wrote:
> Dave Glasser does bring up an interesting point:
> > The more I think about it, the more it seems like two separate APIs is
> > better than one API with a boolean that entirely changes its
> > semantics. For example, I found the documentation for the separated
> > _into function easier to understand than the documentation for the
> > combined function. (I'm still not sure what the combined API should
> > do if you pass a multiple-element array but set copy_as_child to
> > FALSE.) (Also, in the common case of a single-file-copy/move, this
> > requires extra code to create an array.)
>
> I think that we all agree that we want some kind of interface which has
> behavior similar to the traditional cp/mv commands. Whether that
> interface should exist as part of libsvn_client, or simply in the client
> application is another matter. The merged API is an attempt to present
> that kind of interface, but also offer a bit more control to API
> consumers who want it.
With today's version of the docs, I don't think it's too confusing any more.
--dave
--
David Glasser | glasser_at_mit.edu | http://www.davidglasser.net/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Dec 8 18:27:19 2006