summaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authorZachary T Welch <zw@superlucidity.net>2009-11-13 13:38:35 -0800
committerZachary T Welch <zw@superlucidity.net>2009-11-13 13:38:35 -0800
commit6435e75e147a6559ed4f784b5e89c8390e787a2a (patch)
tree90c613626c856ab3c8e5fa1ba2d72ed9bdfdb9d6 /doc/manual
parentef746e27c55c14b7a4f6381c490e5c175e409c0b (diff)
downloadopenocd_libswd-6435e75e147a6559ed4f784b5e89c8390e787a2a.tar.gz
openocd_libswd-6435e75e147a6559ed4f784b5e89c8390e787a2a.tar.bz2
openocd_libswd-6435e75e147a6559ed4f784b5e89c8390e787a2a.tar.xz
openocd_libswd-6435e75e147a6559ed4f784b5e89c8390e787a2a.zip
update developer manual for new types
Update the style guide and chase obvious references to structures that have been renamed.
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/helper.txt2
-rw-r--r--doc/manual/style.txt9
2 files changed, 6 insertions, 5 deletions
diff --git a/doc/manual/helper.txt b/doc/manual/helper.txt
index 7060607c..247d7b42 100644
--- a/doc/manual/helper.txt
+++ b/doc/manual/helper.txt
@@ -75,7 +75,7 @@ handlers or helpers:
The following parameters are defined in the scope of all command
handlers and helpers:
-- <code>struct command_context_s *cmd_ctx</code> - the command's context
+- <code>struct command_context *cmd_ctx</code> - the command's context
- <code>unsigned argc</code> - the number of command arguments
- <code>const char *args[]</code> - contains the command arguments
diff --git a/doc/manual/style.txt b/doc/manual/style.txt
index b6d68b48..b4d02165 100644
--- a/doc/manual/style.txt
+++ b/doc/manual/style.txt
@@ -66,8 +66,9 @@ Finally, try to avoid lines of code that are longer than than 72-80 columns:
- most identifiers must use lower-case letters (and digits) only.
- macros must use upper-case letters (and digits) only.
- OpenOCD identifiers should NEVER use @c MixedCaps.
-- structure names must end with the '_s' suffix.
-- typedef names must end with the '_t' suffix.
+- @c typedef names must end with the '_t' suffix.
+ - This should be reserved for types that should be passed by value.
+ - Do @b not mix the typedef keyword with @c struct.
- use underline characters between consecutive words in identifiers
(e.g. @c more_than_one_word).
@@ -77,7 +78,7 @@ Finally, try to avoid lines of code that are longer than than 72-80 columns:
- @c // comments -- in new code, prefer these for single-line comments
- trailing comma allowed in enum declarations
- designated initializers (@{ .field = value @})
-- variables declarations may be mixed with code
+- variables declarations should occur at the point of first use
- new block scopes for selection and iteration statements
@section styletypes Type Guidelines
@@ -176,7 +177,7 @@ The following guidelines apply to all Doxygen comment blocks:
-# @c function_name() can be used to reference functions
(e.g. flash_set_dirty()).
-# @c struct_name::member_name should be used to reference structure
- fields in the documentation (e.g. @c flash_driver_s::name).
+ fields in the documentation (e.g. @c flash_driver::name).
-# URLS get converted to markup automatically, without any extra effort.
-# new pages can be linked into the heirarchy by using the @c \@subpage
command somewhere the page(s) under which they should be linked: