On May 31, 2011 8:49 PM, <danie...@apache.org> wrote: >... > +++ subversion/trunk/notes/knobs Wed Jun 1 00:48:56 2011 > @@ -17,9 +17,9 @@ The SVN source code boasts a number of e > processor enabled tweaks that are mainly aimed at developer support. > If you introduce new ones, please document them here. > > -The usual namespace rules apply: only names that begin with "SVN_" > -and don't contain double underscores are considered part of the public > -API. Everything else is not officially supported. > +The usual namespace rules apply: names that don't begin with "SVN_" or > +contain double underscores are not part of the public API and may change > +arbitrarily at any time (including between patch releases).
I had a define in workqueue.c that somebody recently prefixed with SVN_. I never intended it to be part of *any* API. just a little helper for us devs. Yet now it shows up in knobs, and is an "official API"?!? Seems we may want to reconsider how stuff magically becomes a "knob". Cheers, -g
