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

issue #1648: depth indicator in internal API

From: <kfogel_at_collab.net>
Date: 2003-12-19 20:32:53 CET

Issue #1648 is about anticipating a possible future UI, the --depth
option, by making some internal function interfaces take a tri-state
'depth' enum instead of a bi-state 'recurse' boolean.

Although there are good arguments both ways (see the issue for links),
I think this change should not go into 1.0, for a couple of reasons.

First, we don't know for sure how the --depth option is going to work,
or that we're definitely going to do it at all. Yes, we've discussed
it, but the enhancement has not been spec'd out to the degree it would
be if we were implementing it right now. It feels wrong to make an
anticipatory internal API adjustment for a feature that isn't even
completely designed yet.

Second, even if the --depth option does get implemented in the near
future, and looks exactly as we expect it to, there are strategies for
dealing with the compatibility issues then. We can keep the current
function names as wrappers around new functions that end in "_depth"
or whatever, officially deprecate the old ones, and then in a future
API-changing release, make the final break in the obvious way.

This strategy can be applied to other API changes too, but I think
it's particularly appropriate here, given that the UI feature for
which we're proposing the new API doesn't even exist yet.

So, I'm not planning to vote for #1648. This mail is not a veto, but
I hope it encourages others to not vote for #1648 as well.


To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Dec 19 21:22:34 2003

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.