I’ve seen this done before in various C++ libraries – namely Qt (QtCore, QtGui, etc.) and Irrlicht (irrlicht.h):
// file - mylibrary.h
#include "someclass1.h"
#include "someclass2.h"
#include "someclass3.h"
// and so on...
Obviously this exists for convenience – a programmer wishing to use the library only has to include one header instead of lots of different ones. My question is, is there a special name for this type of header file? Even if there’s not an "official" name, what you you refer to it as? A "convenience header" or "module header" or something?
Names given so far (with sources):
- Convenience header (Boost)
- Master header (Apple Official Documentation, An MSDN blog)
- Meta-header (The Game Programming Wiki)
User contributions (no sources):
- Header header (Larry Watanabe)
- Umbrella header (Chuck)
That’s a nice question 🙂
I’ve found some sources that call it master header file, e.g:
When it is used to host headers for the header precompiler, it could be called precompiler global header:
However I don’t think that there’s a single widespread way to call it.