On Wed, Sep 09, 2009 at 08:53:22AM -0700, Garrett D'Amore wrote: > I'm not of the opinion that breaking up SUNWhea into smaller packages is > useful. I *am* of the opinion that headers which are Project Private, > or possibly Consolidation Private, should not be packaged at all. (I'd > probably grant a special exception for Consolidation Private interfaces > which are *intended* for public consumption at some future date, but > even that could probably just as easily be dealt with by a future push > after ARC approves the interfaces for public consumption.)
Before OpenSolaris those private headers were quite useful to customers by hinting at implementation details that help observe the system. Now customers have source. If they want to use private interfaces, they will. Shipping or not shipping such headers is not terribly important, but documenting the Public interfaces and putting a warning in the private headers is. > I suppose at one point having those headers on the system was useful for > debugging back when people had to manually work out structures in adb. Among other things. > These days with CTF they are completely unnecessary. Whenever I easily CTF doesn't capture C pre-processor #defines. CTF doesn't capture extern function prototypes. CTF is not a replacement for shipping header files -- CTF really has nothing to do with shipping or not shipping private headers. Nico --
