[remote] Add generic command and pack system to simplify user code.
[vsc-common.git] / HACKING
1 GENERAL
2
3 - private functions and variables are prefixed with an underscore
4 - all functions/types are prefixed with vsc_/Vsc or vsc_cli_/VscCli, the only
5   exceptions are static private functions and completely private types
6 - use vsc_alloc/vsc_free instead of using calloc/free directly
7 - use const pointers to indicate read-only usage of objects
8 - indent with tabs, align with spaces, try to keep the line length below 80
9   characters assuming a tab is 4 spaces long
10 - keep the usage of typedefs and macros at a minimal level to maintain good
11   code readability
12 - read http://dl.fefe.de/optimizer-isec.pdf
13 - use enums for constant values instead of defines, because enum values are
14   visible by name in gdb
15 - use VSC__ASSERT for basic input parameter checks in each function to
16   automatically spot simple errors
17 - write code in a way so that valgrind is happy
18 - ...