On Mar 15, 2007, at 16:55, John Beck wrote:
> I didn't realize until just now that Volatile is in the Public set of
> interface classifications as opposed to the Private set.
The general rule is this: If a customer is allowed to use it (and
especially if they're expected to use it), it's Public. If it's
Public, it must be documented. In general, Private interfaces are not
documented (except internally, of course); if there is public
documentation, it must note that the interface is not for public use.
The presence of an interface in a header file does not constitute
documentation.
--Ed