Coding Conventions

From WinBolo

(Difference between revisions)
Jump to: navigation, search
(initial settings)
(Method Header Comments)
Line 2: Line 2:
== Method Header Comments ==
== Method Header Comments ==
 +
 +
This should go above every method, both it's implementation (in .c files) and definition (in .h files).
 +
<pre>
 +
/*********************************************************
 +
*NAME:          <functionName>
 +
*AUTHOR:        <functionAuthor>
 +
*CREATION DATE: <DD/MM/YY>
 +
*LAST MODIFIED: <DD/MM/YY>
 +
*PURPOSE:
 +
*  Short description of function goes here
 +
*
 +
*ARGUMENTS:
 +
*  firstParameter  - Short explanation of what this parameter is
 +
*  secondParameter - Short explanation of what this parameter is
 +
*********************************************************/
 +
</pre>
== File Header Comments ==
== File Header Comments ==

Revision as of 21:54, 11 February 2009

Contents

Comments

Method Header Comments

This should go above every method, both it's implementation (in .c files) and definition (in .h files).

/*********************************************************
*NAME:          <functionName>
*AUTHOR:        <functionAuthor>
*CREATION DATE: <DD/MM/YY>
*LAST MODIFIED: <DD/MM/YY>
*PURPOSE:
*  Short description of function goes here
*
*ARGUMENTS:
*  firstParameter  - Short explanation of what this parameter is
*  secondParameter - Short explanation of what this parameter is
*********************************************************/

File Header Comments

Single Line Comments

Multiline Comments

Variable Cases

Indentions

Conditionals

Methods

Personal tools