Document which functions are designed to be called at runtime

[mscroggs]

Using Doxygen's @note to say which functions are intended to be called at runtime so its clear which functions need to be fast and which are only ever called once