After over 20 years working with C/C++ I finally got clear idea how header files need to be organized. Most of the projects in C++ world simply dump everything in .h file, and most of my C++ code was organized this way. Lately I started to separate function declaration from implementation as it was done in C. Now .h
headers are exclusevely intended for function and class declaration with doxygen documentation style comments. Inline implementation of functions, class method implementation, etc. goes into .inl
headers or .cpp
files.
For example .h
file would contain only declaration and doxygen style documentation comment:
/// Convert size in bytes to human readable string.
void prettify(char* _out, int32_t _max, uint64_t _value)