Difference between revisions of "OOP344 - Team Nothing - 20102"

From CDOT Wiki
Jump to: navigation, search
m
Line 36: Line 36:
  
 
=4.0 Conventions and Styles=
 
=4.0 Conventions and Styles=
==4.1 Function Naming Convention==
+
==4.1 Function Conventions==
Function names are all lowercase and each word are separated by a _
+
===4.1.1 Function Naming Convention===
 +
Function names are all lowercase and each word is separated by an underscore character.
  
 
<pre>
 
<pre>
 +
int do_something()
 +
{
 +
  code;
 +
}
 +
</pre>
 +
 +
===4.1.2 Function Comments===
 +
Each function definition should include a comment above it that includes the function name, a brief and clear description of what each variable does in the function, and a clear and concise description of what the function does.
 +
<pre>
 +
/*
 +
* Function Name: function_name
 +
* Description: This is a clear and concise function description.
 +
* Variable: variable1 - this variable holds the value of something for some purpose
 +
*          variable2 - this variable holds the value of something else for some other purpose
 +
*/
 
int function_name()
 
int function_name()
 
{
 
{
 +
 
   code;
 
   code;
 +
 
}
 
}
 
</pre>
 
</pre>
  
==4.2 Variable Convention==
+
==4.2 Variable Conventions==
 
===4.2.1 Naming Convention===
 
===4.2.1 Naming Convention===
 
Similar to the [[OOP344_-_Team_Nothing_-_20102#4.1 Function Naming Convention|4.1 Function Naming Convention]]
 
Similar to the [[OOP344_-_Team_Nothing_-_20102#4.1 Function Naming Convention|4.1 Function Naming Convention]]
  
For Compound:
+
For Compound Variable Names:
 
<pre>
 
<pre>
 
int some_var;
 
int some_var;
Line 57: Line 75:
 
OR
 
OR
  
For Single:
+
For Non-compound Variable Names:
 
<pre>
 
<pre>
 
int var;
 
int var;
 
</pre>
 
</pre>
  
===4.2.2 Creating===
+
===4.2.2 Variable Definitions===
Each variable should be on it's own line
+
Define each variable on a speparate line.
  
 
<pre>
 
<pre>
Line 70: Line 88:
 
</pre>
 
</pre>
  
==4.3 Indent Level==
+
==4.3 File Headings==
The indent level in any case will consist of three spaces.  There will be no tab use.
+
Each file with the extension of *.cpp, *.c, and *.h must include a comment heading at the beginning of the file stating the file name, author (and username), date created, last modified date, and description of what the file does.  The description should be clear and concise.  This must be enclosed using /* and */.
 
 
<pre>
 
int someFunction
 
{
 
 
 
  code;
 
  more code;
 
 
 
}
 
</pre>
 
 
 
==4.4 File Heading==
 
Each file with the extension of *.cpp, *.c, and *.h must include a comment heading stating the file name, author (and username), date created, last modified date, and description of what the file does.  The description should be clear and concise.  This must be enclosed using /* and */.
 
  
 
<pre>
 
<pre>
 
/*
 
/*
 
  * File Name: example.cpp
 
  * File Name: example.cpp
  * Author: Name (senecaid)
+
  * Author: Name (seneca id)
  * Create Date: 23-May-10
+
  * Date Created: 23-May-10
 
  * Last Modified Date: 11-Nov-10
 
  * Last Modified Date: 11-Nov-10
  * Description: blah blah blah
+
  * Description: This is a clear and concise description of the file.
 
  */
 
  */
 
</pre>
 
</pre>
  
==4.5 Function Comments==
+
 
Each function should include a comment above the function similar to the file heading ([[OOP344_-_Team_Nothing_-_20102#4.4 File Heading|4.4 File Heading]]), except only including the function name, what each variable does in the function, and a description of what the function does
+
==4.4 Indentation Level==
 +
Use an indentation level of three spaces in all situations. Do not use TAB for indentation.
 +
 
 
<pre>
 
<pre>
/*
+
int some_function()
* Function Name: function_name
 
* Description: Blah blah blah.
 
* Variable: variable1 - this does this to this function
 
*          variable2 - this is 2
 
*/
 
int function_name()
 
 
{
 
{
  
  code;
+
  code;
 +
  more code;
  
 
}
 
}
 
</pre>
 
</pre>
  
==4.6 Curly Braces==
+
==4.5 Curly Braces==
Use of { } in a code block, such as in an if statement, a for loop, should start on a new line, with the { } lined up with the first character of the line above it.  If the code block only has one coded line for the result, please use the curly brackets anyways for readability’s sake.
+
Each { and } for a code block, such as in an if statement or a for loop, should be placed on its own separate line, with the { and } lined up with the first character of the line above it.  If the code block consists of only one line of code, continue to use the curly braces for clarity and in case additional code is added afterwards.
 
<pre>
 
<pre>
 
void function()
 
void function()
Line 134: Line 136:
 
</pre>
 
</pre>
  
==4.7 Conditional Compilation==
+
==4.6 Conditional Compilation==
 +
===4.6.1 Naming Convention for Header Files===
 +
Prefix the names of header files that we create with "tn" (initials of Team Nothing) followed by an underscore character. For example, tn_headerfile.h
 +
 
 +
When using conditional comiplation, use the following format for a file named tn_headerfile.h:
  
 
<pre>
 
<pre>
#ifndef _tn_headerfilename_h
+
#ifndef _tn_headerfile_h_
 +
#define _tn_headerfile_h_
 
</pre>
 
</pre>

Revision as of 22:34, 30 May 2010


OOP344 | Weekly Schedule | Student List | Teams | Project | Student Resources

1.0 Participants

1.1 Team Members

OOP344 - Team Nothing - 20102
ID First Name Last Name Section Seneca Id wiki id IRC nick Blog URL
A Alex Chung A acchung1 acchung1 acchung1 my blog
B Don Armin Napao A danapao danapao danapao My Blog
C Robin Co A rco1 imadorki3 rco1 My Blog
D Bhavanesh Patel A bapatel5 bapatel5 Bhavanesh My Blog
E Kerry Singh A kmsingh sinker sinker My Blog


1.2 Team Contact Person

Kerry Singh
IRC Nick: sinker


2.0 Project Development Page

Project Development Page


3.0 IRC Chatlogs / Meeting Logs

IRC meeting logs

3.1 30-May-10

Channel #Team-Nothing

4.0 Conventions and Styles

4.1 Function Conventions

4.1.1 Function Naming Convention

Function names are all lowercase and each word is separated by an underscore character.

int do_something()
{
  code;
}

4.1.2 Function Comments

Each function definition should include a comment above it that includes the function name, a brief and clear description of what each variable does in the function, and a clear and concise description of what the function does.

/*
 * Function Name: function_name
 * Description: This is a clear and concise function description.
 * Variable: variable1 - this variable holds the value of something for some purpose
 *           variable2 - this variable holds the value of something else for some other purpose
 */
int function_name()
{

  code;

}

4.2 Variable Conventions

4.2.1 Naming Convention

Similar to the 4.1 Function Naming Convention

For Compound Variable Names:

int some_var;

OR

For Non-compound Variable Names:

int var;

4.2.2 Variable Definitions

Define each variable on a speparate line.

int var1;
int var2;

4.3 File Headings

Each file with the extension of *.cpp, *.c, and *.h must include a comment heading at the beginning of the file stating the file name, author (and username), date created, last modified date, and description of what the file does. The description should be clear and concise. This must be enclosed using /* and */.

/*
 * File Name: example.cpp
 * Author: Name (seneca id)
 * Date Created: 23-May-10
 * Last Modified Date: 11-Nov-10
 * Description: This is a clear and concise description of the file.
 */


4.4 Indentation Level

Use an indentation level of three spaces in all situations. Do not use TAB for indentation.

int some_function()
{

   code;
   more code;

}

4.5 Curly Braces

Each { and } for a code block, such as in an if statement or a for loop, should be placed on its own separate line, with the { and } lined up with the first character of the line above it. If the code block consists of only one line of code, continue to use the curly braces for clarity and in case additional code is added afterwards.

void function()
{
   if(some-condition)
   {
      code;
   }
}

if(some-condition)
{
   code;
}
else
{
   code;
}

4.6 Conditional Compilation

4.6.1 Naming Convention for Header Files

Prefix the names of header files that we create with "tn" (initials of Team Nothing) followed by an underscore character. For example, tn_headerfile.h

When using conditional comiplation, use the following format for a file named tn_headerfile.h:

#ifndef _tn_headerfile_h_
#define _tn_headerfile_h_