> > The entire contents of mod_ssl.h just cannot be considered a public API, > > that's too much, even the config structures are in there. The only > > thing that's usable from other modules is the optional hook, and in > > reality that declaration just gets cut'n'pasted anyway (even by > > third-party modules I've seen). > > Agreed. > > Without the proper API wrapper (AP_DECLARE) a function may fail to be usable > multiplatform anyway. Anything without API wrappers should be considered > implementation details. > > We could issue an RFC on this issue with next stable release, stating how > module authors can determine whether a callable function in an Apache header > file is considered an API, and explaining our need to modify implementation > details as necessary to keep the code base maintainable as we make fixes and > enhancements. Any screaming could hopefully be converted into clear requests > for certain interfaces to be considered APIs.
Sounds like a good plan. +1 david
