Coding Conventions
From WinBolo
(Difference between revisions)
(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 *********************************************************/