RFC Rules for installation of header files

[Alex Merry]

On 06/11/13 13:52, Aurélien Gâteau wrote:
> ## Most likely needed for SC
> 
> Those headers were already there in KDE4.
> 
> - conversion_check.h
> - fixx11h.h
> - kgenericfactory.tcc
> - netwm_def.h
> - netwm.h
> - predicateproperties.h
> - threadweaver installs headers as {lowercase}/{CamelCase}.h, instead of
>   {lowercase}/{lowercase}.h
> - KDE/kdbgstream
> - KDE/kndbgstream
> - KDE/NET
> - KDE/NETRootInfo
> - KDE/NETWinInfo
> - KDE/OrgKdeKDirNotifyInterface
> - KDE/PtyProcess: this one comes from kdesu, but there is also
>   KPtyProcess (from kpty). That is potentially confusing.
> - KDE/SshProcess
> - KDE/StubProcess
> - KDE/SuProcess
> - KDE/ThumbCreator
> - khtml installs CamelCase headers in KDE/khtml, instead of KDE/KHTML.

One option would be to create/generate compatibility headers that
contained #warning directives telling people to update their #includes
(at least for the headers that do not just contain deprecated code, like
predicateproperties.h).  That would allow us to ditch them at KF6 time.

We might also be willing to break SC for those headers that are not very
commonly used (conversion_check.h, for example, appears to be internal
API that is only installed for the benefit of inline code).

Alex