document
This commit is contained in:
parent
1e46b40a2e
commit
da0d5f22ac
@ -133,12 +133,7 @@ Following the style guide makes it easier for the next programmer to understand
|
|||||||
* Do not use new or malloc (making memory leaks impossible).
|
* Do not use new or malloc (making memory leaks impossible).
|
||||||
* If class has any non-[POD](http://en.wikipedia.org/wiki/Plain_old_data_structure) data members, [do not inline constructors and destructors](http://www.chromium.org/developers/coding-style/cpp-dos-and-donts).
|
* If class has any non-[POD](http://en.wikipedia.org/wiki/Plain_old_data_structure) data members, [do not inline constructors and destructors](http://www.chromium.org/developers/coding-style/cpp-dos-and-donts).
|
||||||
* Document class interface in .h file, above the class declaration.
|
* Document class interface in .h file, above the class declaration.
|
||||||
* Code should be self-documenting.
|
* Code should be self-documenting. The only comments should be things that may need clarification. A simple function with a good name needs no comment.
|
||||||
The only comments should be things that may need clarification.
|
|
||||||
A simple function with a good name needs no comment.
|
|
||||||
|
|
||||||
<!-- http://stackoverflow.com/questions/2198241/best-practice-for-c-function-commenting -->
|
|
||||||
|
|
||||||
* Code is automatically formated before being pushed to the keybrd repository
|
* Code is automatically formated before being pushed to the keybrd repository
|
||||||
The options file doc/astyle_cpp specifies the format:
|
The options file doc/astyle_cpp specifies the format:
|
||||||
* Allman style indentation
|
* Allman style indentation
|
||||||
@ -146,6 +141,8 @@ Following the style guide makes it easier for the next programmer to understand
|
|||||||
* replace tabs with spaces
|
* replace tabs with spaces
|
||||||
* maximum code width of 100 columns
|
* maximum code width of 100 columns
|
||||||
|
|
||||||
|
<!-- http://stackoverflow.com/questions/2198241/best-practice-for-c-function-commenting -->
|
||||||
|
|
||||||
## trace of keybrd scan
|
## trace of keybrd scan
|
||||||
Arduino does not have a debugger; so here is a list of functions in the order that they are called.
|
Arduino does not have a debugger; so here is a list of functions in the order that they are called.
|
||||||
Refer to it like a table of contents while reading the keybrd library.
|
Refer to it like a table of contents while reading the keybrd library.
|
||||||
|
Reference in New Issue
Block a user