Add commentary about inlining in header files

...since that can get very ugly very fast in larger projects, and is
done here to hint to human readers at what the compiler would be
expected to do on its own accord rather than as something which is
necessary to get the compiler to optimize away the overhead of calling
a three-line function run in inner-loop code.