kingkevin
/
espressif_tinyusb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

markdown format

This commit is contained in:
hathach 2013-05-08 12:50:53 +07:00
parent f03739ce6f
commit 797d464ec4
1 changed files with 13 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
readme.md
View File

@ -77,28 +77,30 @@ MISRA-C is well respected & a bar for industrial coding standard.
### Power of 10 ###
is a small & easy to remember but yet powerful coding guideline. Most (if not all) of the rules here are included in JPL. Because it is very small, all the rules will be listed here, those with bold is compliant, italic is violated.
is a small & easy to remember but yet powerful coding guideline. Most (if not all) of the rules here are included in JPL. Because it is very small, all the rules will be listed here, those with *italic* is compliant, **bold** is violated.
1. **`Restrict to simple control flow constructs`** yes, I hate goto statement, therefore there is none of those here
1. *`Restrict to simple control flow constructs`*
yes, I hate goto statement, therefore there is none of those here
2. **`Give all loops a fixed upper-bound`** one of my favorite rule
2. *`Give all loops a fixed upper-bound`*
one of my favorite rule
3. **`Do not use dynamic memory allocation after initialization`**
3. *`Do not use dynamic memory allocation after initialization`*
the tinyusb uses the static memory for all of its data.
4. *`Limit functions to no more than 60 lines of text`* 60 is a little bit too strict, I will update the relaxing number later
4. **`Limit functions to no more than 60 lines of text`** 60 is a little bit too strict, I will update the relaxing number later
5. **`Use minimally two assertions per function on average`** not sure the exact number, but I use a tons of those assert
5. *`Use minimally two assertions per function on average`* not sure the exact number, but I use a tons of those assert
6. **`Declare data objects at the smallest possible level of scope`** one of the best & easiest rule to follow
6. *`Declare data objects at the smallest possible level of scope`* one of the best & easiest rule to follow
7. **`Check the return value of non-void functions, and check the validity of function parameters`** I did check all of the public application API's parameters. For internal API, calling function needs to trust their caller to reduce duplicated check.
7. *`Check the return value of non-void functions, and check the validity of function parameters`* I did check all of the public application API's parameters. For internal API, calling function needs to trust their caller to reduce duplicated check.
8. *`Limit the use of the preprocessor to file inclusion and simple macros`* Although I prefer inline function, however C macros are far powerful than that. I simply cannot hold myself to use, for example X-Macro technique to simplify code.
8. **`Limit the use of the preprocessor to file inclusion and simple macros`** Although I prefer inline function, however C macros are far powerful than that. I simply cannot hold myself to use, for example X-Macro technique to simplify code.
9. **`Limit the use of pointers. Use no more than two levels of dereferencing per expression`** never intend to get in trouble with complex pointer dereferencing.
9. *`Limit the use of pointers. Use no more than two levels of dereferencing per expression`* never intend to get in trouble with complex pointer dereferencing.
10. **`Compile with all warnings enabled, and use one or more source code analyzers`** I try to use all the defensive option of gnu, let me know if I miss some.
10. *`Compile with all warnings enabled, and use one or more source code analyzers`* I try to use all the defensive option of gnu, let me know if I miss some.
>-pedantic -Wextra -Wswitch-default -Wunsafe-loop-optimizations -Wcast-align -Wlogical-op -Wpacked-bitfield-compat -Wpadded -Wnested-externs -Wredundant-decls -Winline -Wpacked
### JPL ###