summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authordrath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2008-03-02 16:46:37 +0000
committerdrath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2008-03-02 16:46:37 +0000
commit64dbef69e73714208e791958fff060c4fc7960e2 (patch)
tree3df718783b9d87f06242623af219087a576759e7 /README
parent6e45e8825124010a56d3ca7367544be2237af6f3 (diff)
downloadopenocd+libswd-64dbef69e73714208e791958fff060c4fc7960e2.tar.gz
openocd+libswd-64dbef69e73714208e791958fff060c4fc7960e2.tar.bz2
openocd+libswd-64dbef69e73714208e791958fff060c4fc7960e2.tar.xz
openocd+libswd-64dbef69e73714208e791958fff060c4fc7960e2.zip
- 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--README32
1 files changed, 31 insertions, 1 deletions
diff --git a/README b/README
index 1d9bd5ab..0d0a7e2b 100644
--- a/README
+++ b/README
@@ -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.