1
edit
Changes
→OOP344 northWind87: Raised all elements one level higher
While no one will be prosecuted or killed if they forget one or more of these, the others will gently '''remind''' the person in question to '''follow the guidelines''' :)
* ''' Camel Notation ''' should be used for variable names and function names
** ''' ie ''' <code>myVar, bigInt, getNumber(), myFunction()</code>
** ''' ie ''' <code>__CIOL_H__, __IO_FORM_H__</code>
* Pointer declaration should ''' emphasize the type ''' with the <b>"*"</b> being pushed against the right side of the data type as opposed to the left side of the variable name.
** ''' ie ''' <code>char* str, int* num, void* addr</code>
** ''' ie ''' <code>void doStuff(void), int getInt(void)</code>
The first left parenthesis on a function declaration should open immediately after the function name while the first left parenthesis on a loop declaration should open one space after the loop declaration.<br />
''' ie Functions: '''
''' ie ''' <code>x = getInt(), someInt = y + bigSum(y, r)</code>
Both function blocks and loop blocks should open on the same line as the declaration statement preceding them; however, function blocks should open immediately after the last right parenthesis while loop blocks should open one space after the last right parenthesis.<br />
''' ie Functions: '''
do (blah) {</pre>
All functions should have a comment block preceding them which should explain what the function does in a few brief sentences, what parameters it receives with each parameter having a section preceded by <code>@param</code>, and anything that the function may return preceded by <code>@return</code> at the end of the block. Try to keep things lined up so that they're easier to read.