Re: API/Interface design questions

C. Michael Pilato wrote:

> The published API lives in subversion/include, where all functions
> have single underscores. These are highly impacted by our versioning
> requirements.

That's what I thought.

>
> "Semi-public" (which is a term I too use) would be stuff in .h files
> scattered amongst the library subdirs themselves
> (clients/cmdline/cl.h, libsvn_wc/wc.h, etc.). These functions have
> double underscores and are not impacted by our versioning
> requirements.

So to merge what you and Karl are saying, the double underscore functions are
only shared amongst the other files that make up a given library. They cannot
be used by functions in other libraries.

>
> Finally, I used "private" to mean those functions that don't live in
> any .h files, are marked "static", and are visible only to the other
> functions in their particular .c file.

Of course! That's my definition as well...

So it looks like anything in libsvn_subr (which is a provider for several other
libraries) has to be part of the public API, even the really low level stuff
which just happens to be used by several other libraries. Hmmm, not what I
wanted to hear. ;~(

John

-- 
John Peacock
Director of Information Research and Technology
Rowman & Littlefield Publishing Group
4501 Forbes Boulevard
Suite H
Lanham, MD  20706
301-459-3366 x.5010
fax 301-429-5748
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org