diff options
author | drath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60> | 2008-03-02 16:46:37 +0000 |
---|---|---|
committer | drath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60> | 2008-03-02 16:46:37 +0000 |
commit | 64dbef69e73714208e791958fff060c4fc7960e2 (patch) | |
tree | 3df718783b9d87f06242623af219087a576759e7 /README | |
parent | 6e45e8825124010a56d3ca7367544be2237af6f3 (diff) | |
download | riscv-openocd-64dbef69e73714208e791958fff060c4fc7960e2.zip riscv-openocd-64dbef69e73714208e791958fff060c4fc7960e2.tar.gz riscv-openocd-64dbef69e73714208e791958fff060c4fc7960e2.tar.bz2 |
- Added coding style to README
git-svn-id: svn://svn.berlios.de/openocd/trunk@433 b42882b7-edfa-0310-969c-e2dbd0fdcd60
Diffstat (limited to 'README')
-rw-r--r-- | README | 32 |
1 files changed, 31 insertions, 1 deletions
@@ -134,7 +134,37 @@ http://openfacts.berlios.de/index-en.phtml?title=Open_On-Chip_Debugger. There is also and openocd(1) manpage, the 'openocd --help' output and an OpenOCD info page (type 'info openocd'). -5. Licensing +5. Coding Style + +The following rules try to describe formatting and naming conventions that +should be followed to make the whole OpenOCD code look more consistent. +The ultimate goal of coding style should be readability, and these rules may +be ignored for a particular (small) piece of code if that makes it more +readable. + +Formatting rules: +- remove any trailing white space +- use TAB characters for indentation, not spaces +- displayed TAB width is 4 characters +- make sure NOT to use DOS '\r\n' line feeds +- do not add more than 2 empty lines to source files +- do not add trailing empty lines to source files +- do not use C++ style comments (//) +- lines may be reasonably wide - there's no anachronistic 80 characters limit + +Naming rules: +- identifiers use lower-case letters only +- identifiers consisting of multiple words use underline characters between +consecutive words +- macros use upper-case letters only +- structure names shall be appended with '_s' +- typedefs shall be appended with '_t' + +Function calls: +- function calls have no space between the functions name and the parameter +list: my_func(param1, param2, ...) + +6. Licensing OpenOCD is licensed under the terms of the GNU General Public License, see the file COPYING for details. |