The meaning of double-underscore symbols

I don't believe we've ever defined *exactly* what the significance of a
double-underscore symbol name is.
Two of definitions I've heard of are:

(a) anything that should not be used by users, but can we used at will
internally by the Subversion libraries.

(b) symbols that should have visibility only to the library that they are
defined in, and should not be used *anywhere* outside that library.

The double-underscore symbols which do not meet the strictest definition
are:

svn_error__locate: used almost everywhere
svn_sort__hash: used by libsvn_client, mod_dav_svn, and svn
svn_{fs,ra}_foo__init: linked into the loader libs
svn_txdelta__apply_instructions, svn_txdelta__compose_windows: used by the
fs backends

If anyone knows of an official definition of what svn_foo__bar means, please
tell me, otherwise, opinions and thoughts welcome, so we can craft an
official definition.

Max.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Oct 4 16:00:26 2005