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


Reply via email to