(Reminder, see File layout)
Lines MUST NOT exceed 80 characters in width, including the trailing
newline character.
Function declarations SHOULD be preceded by a Doxygen comment
explaining the purpose of the function. This explanatory comment
SHOULD contain a description of the arguments, the error cases, the
return value (if any) and the algorithm implemented by the function.
Function bodies MAY contain comments and blank lines.
Functions' body MUST NOT contain more than 50 lines. The
enclosing braces are excluded from this count as well as the blank lines
and comments.