| 70 | === Header files === |
| 71 | |
| 72 | * Header guards should look like: |
| 73 | * {{{_LIBC_SYS_TIME_H}}} for libraries |
| 74 | * [{{{LOCSRV_}}}]{{{CATEGORY_H}}} for servers |
| 75 | * {{{SHEET_H}}} for applications |
| 76 | * Function declarations should be marked extern |
| 77 | * Function declarations (same as forward static function declarations) should omit argument names |
| 78 | * Preferred order of #include directives is angle-bracketed, then quoted |
| 79 | * Second level of ordering is lexicographic |
| 80 | * Give an honest attempt at IWYU (include what you use) |
| 81 | * Each source module shall directly include the header file containing any symbol it uses |
| 82 | * Except if there is an 'interface' header file that is meant to be included instead |
| 83 | * Specifically, do not rely on an {{{$include "common.h"}}} to blanket-include all header files to all your source modules |
| 84 | |