Difference between revisions of "OOP344 - HOTYS - 20102"

From CDOT Wiki
Jump to: navigation, search
(Coding Style Rules: v5 more rules added)
(IRC Schedule/Log: - Added Log 7)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{OOP344 Index}}
 
{{OOP344 Index}}
<p>
+
= <big>'''HOTYS Homepage'''</big> =
This is team '''HOTYS''' homepage!!!</p>
+
 
 +
<p>Welcome to '''HOTYS''' homepage!!!</p>
 
<p>The Name of the team is derived from the first letter of each group member's name:</p>
 
<p>The Name of the team is derived from the first letter of each group member's name:</p>
  
Line 10: Line 11:
 
<span style="font-size: 1.75em; font-weight: bolder;">S</span>tephanie Law <br />
 
<span style="font-size: 1.75em; font-weight: bolder;">S</span>tephanie Law <br />
 
<br />
 
<br />
 
 
 
== <big>Member List</big> ==
 
== <big>Member List</big> ==
 
{| class="wikitable sortable" border="1" cellpadding="5"
 
{| class="wikitable sortable" border="1" cellpadding="5"
Line 24: Line 23:
  
 
|-
 
|-
| c || Kim || Tony || [mailto:kjkim@learn.senecac.on.ca kjkim] || A || [http://kijeongkim.blogspot.com/ My Blog] || TonyKim || [[Special:Contributions/kjkim| kjkim]]
+
| c || Kim || Tony(Kijeong) || [mailto:kjkim@learn.senecac.on.ca kjkim] || A || [http://kijeongkim.blogspot.com/ My Blog] || TonyKim || [[Special:Contributions/kjkim| kjkim]]
  
 
|-
 
|-
| d || Jeong || YuJin ||[mailto:yjeong@learn.senecac.on.ca yjeong] || A || [http://yujinjeong.wordpress.com/ Spirit & Soul] || YuJin|| [[Special:Contributions/Takeiteasy| Takeiteasy ]]
+
| d || Jeong || YuJin ||[mailto:yjeong@learn.senecac.on.ca yjeong] || A || [http://yujinjeong.wordpress.com/ Spirit & Soul] || _YJ_|| [[Special:Contributions/Takeiteasy| Takeiteasy ]]
  
 
|-
 
|-
 
| e || Law ||  Stephanie ||[mailto:slaw12@learn.senecac.on.ca slaw12] - || A || [http://slaw12.wordpress.com/ My Blog]-  ||Slaw12 ||[[Special:Contributions/slaw12| slaw12]]
 
| e || Law ||  Stephanie ||[mailto:slaw12@learn.senecac.on.ca slaw12] - || A || [http://slaw12.wordpress.com/ My Blog]-  ||Slaw12 ||[[Special:Contributions/slaw12| slaw12]]
 
|}
 
|}
 +
<br />
  
== <big>Team Project</big> ==
+
== <big>Project Development Page</big> ==
[http://zenit.senecac.on.ca/wiki/index.php/OOP244_-_HOTYS_Project_Dev_Page_-_20101 Team Project]
+
[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_Project_Dev_Page_-_20101 Team Project]
 
+
<br />
  
 
== <big>Discussions</big> ==
 
== <big>Discussions</big> ==
 
[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_Discussion_-_20102 Discussion Page]
 
[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_Discussion_-_20102 Discussion Page]
  
 
+
<br />
 
== <big>IRC Schedule/Log</big> ==
 
== <big>IRC Schedule/Log</big> ==
[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_20102 IRC Page]
+
<span style="font-size: 125%; font-weight: bolder; color: #FF0000; text-decoration: overline underline;">&nbsp;&nbsp;Group meetings will be held on Sundays at 12pm in #seneca-HOTYS.&nbsp;&nbsp;</span><br />
 +
Logs:
 +
<ul>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_052310_-_20102 Log 1] - This meeting mainly covered coding styles to be used and other group norms</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_053010_-_20102 Log 2] - This meeting mainly is us waiting for Fardad to show up.  We later decided to split the functions and get to work since the assignment page was already up</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_060610_-_20102 Log 3] - This meeting we went over the simple functions and added v0.1 in tags as a group.  Had some Borland Problems we fixed.</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_060613_-_20102 Log 4] - This meeting we went over the distribution list.</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_062010_-_20102 Log 5] - This meeting was focused on fixing bugs and committing to trunk in preparation of Fardad's test main</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_071810_-_20102 Log 6] - This meeting we distributed the project's work and created a rough time line for completion.</li>
 +
  <li>[http://zenit.senecac.on.ca/wiki/index.php/OOP344_-_HOTYS_IRC_Logs_-_072510_-_20102 Log 7] - This meeting we put together all classes and went over bugs to fix and features to add. HOTYS - TextEdit v0.2 was committed to trunk
 +
</ul>
 +
<br />
  
 
==<big>Coding Style Rules</big>==
 
==<big>Coding Style Rules</big>==
<pre>
+
Every file should have a function header with:<br />
Every file should have a function header with:
+
<ul>
File name
+
  <li>File name</li>
Programmer Full name
+
  <li>Programmer Full name</li>
Date last modified
+
  <li>Date last modified</li>
 +
</ul>
 +
 
 +
Example:<br />
 +
<div>
 +
<b style="color: #008800; line-height: 0.5em;">
 +
  <span style="color: #008800;">/*<br />
 +
  Title<br />
 +
  Title.h<br />
 +
  By: Full Name<br />
 +
  Date Last Modified: 9:59 AM April-15-10<br />
 +
  Description of what is in the file<br />
 +
  */<br />
 +
  </span>
 +
</b>
 +
</div>
 +
<br />
  
Variable names should be meaningful so additional comments are not necessary to explain what the variable does
+
Variable names should be meaningful so additional comments are not necessary to explain what the variable does.
 +
 
 +
Example:
 +
<div>
 +
<b style="color: #000000; line-height: 0.5em;">
 +
  int nNum; <span style="color: #008800;">//Bad</span><br />
 +
  int nNumOfTypes <span style="color: #008800;">//Good</span><br />
 +
</b>
 +
</div>
 +
<br />
  
 
A lower case prefix should be fitted to the variable name to help describe it at a glance:
 
A lower case prefix should be fitted to the variable name to help describe it at a glance:
n int
 
c character
 
b Boolean
 
f fload
 
d double
 
s C-style null terminated string OR a string object
 
p Pointers
 
  
Ex:
+
<table border="1" cellspacing="3" cellpadding"5">
nNumOfSignals
+
  <tr style="border: 1px solid #000000; text-align: center;">
cCharPassed
+
      <th>Prefix</th>
bIsTrue
+
      <th>Data Type</th>
fLength
+
      <th>Example</th>
dWidth
+
  <tr style="border: 1px solid #000000; text-align: center;">
sUserInput
+
      <td>n</td>
pnNumOfSignals
+
      <td>int</td>
 +
      <td>nNumOfSignals</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>c</td>
 +
      <td>char</td>
 +
      <td>cTypeMode</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>b</td>
 +
      <td>boolean</td>
 +
      <td>bIsTrue</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>f</td>
 +
      <td>float</td>
 +
      <td>fLength</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>d</td>
 +
      <td>double</td>
 +
      <td>dWidth</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>s</td>
 +
      <td>C-Style null terminated string<br />OR a String object</td>
 +
      <td>sUserInput</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>p</td>
 +
      <td>pointers</td>
 +
      <td>pnNumOfSignals</td>
 +
  </tr>
 +
  <tr style="border: 1px solid #000000; text-align: center;">
 +
      <td>m_</td>
 +
      <td>Data Member/<br />Instance Variable</td>
 +
      <td>m_pnNumOfSignals<br /><b>NOT</b><br />pnm_NumOfSignals<br /><b>OR</b><br />mpn_NumOfSignals</td>
 +
  </tr>
 +
</table>
  
Also for Classes, ALL Data Member should have a m_ prefixed to the name to show that it is a Data Member ( Instance Variables )
+
All variable declarations should be done on their own lines!
Ex:
 
int m_nType;
 
NOT
 
int nm_Type OR INT mn_Type;
 
  
All variable declaration should be done on it's own line
+
There should be NO single character names for variables (Ex: i, j, k, etc) except for arbitrary counters, such as for for loops
  
There should be NO single character names for variables (Ex: i, j, k, etc) except for arbitrary counters, such as for loops
+
All const and #define Variable names should be in All Caps
  
All const and #define Variable names should be in All Caps
+
Example:<br />
ex:
+
<div>
const int MAX_TRIPS;
+
<b style="color: #000000; line-height: 0.5em;">
#define MAX_TRIPS 1
+
  const int nMAX_TRIPS;<br />
 +
  #define MAX_TRIPS 1<br />
 +
</b>
 +
</div>
 +
<br />
 +
 
 +
 
 +
 
 +
Pointers should be declared in C++ style:
 +
 
 +
Example:<br />
 +
<div>
 +
<b style="color: #000000; line-height: 0.5em;">
 +
  int* x;<br />
 +
  NOT<br />
 +
  int * x; OR int *x;<br />
 +
</b>
 +
</div>
 +
<br />
  
Pointers should be defined in C++ style:
+
Class names should be all lower case except for the first letter, which should be upper case.
int* x;
 
NOT
 
int * x; OR int *x;
 
  
 +
Function names should have meaningful names (They do not require prefix).
  
Function names should have meaningful names (they do not require prefix)
 
 
Function names Should be all lower case except for the First letter of each Word.
 
Function names Should be all lower case except for the First letter of each Word.
Each function should have only one point of entry and one point of exit.
+
 
I.E. There should be only 1 return statement in each function.
+
Example:<br />
 +
<div>
 +
<b style="color: #000000; line-height: 0.5em;">
 +
  GetChar();<br />
 +
  NOT<br />
 +
  getChar(); OR Getchar();<br />
 +
</b>
 +
</div>
 +
<br />
 +
 
 +
 
 +
Each function should have only one point of entry and one point of exit! I.E. There should be only 1 return statement in each function.
  
 
Each function should have a header describing what it does.
 
Each function should have a header describing what it does.
  
 
Use Inline comments to describe hard to read code.  All inline code should be set to the same indention as the code it is describing.  
 
Use Inline comments to describe hard to read code.  All inline code should be set to the same indention as the code it is describing.  
 +
 +
Example:<br />
 +
<div>
 +
<b style="color: #000000; line-height: 0.5em;">
 +
    //Comment<br />
 +
    GetChar();<br  />
 +
    NOT<br />
 +
//Comment<br />
 +
    GetChar()<br />
 +
</b>
 +
</div>
 +
<br />
  
  
 
Opening braces should be on the same line as the defining function/if/else if/etc statement.
 
Opening braces should be on the same line as the defining function/if/else if/etc statement.
Ex:
 
void FunctionOne(int){
 
if (x > y){
 
NOT
 
void FunctionOne(int)
 
{
 
if (x > y)
 
{
 
  
 +
Example:<br />
 +
<div>
 +
<b style="color: #000000; line-height: 0.5em;">
 +
  void FunctionOne(int){<br />
 +
      if (x > y){<br />
 +
  NOT<br />
 +
  void FunctionOne(int)<br />
 +
  {<br />
 +
      if (x > y)<br />
 +
      {<br />
 +
</b>
 +
</div>
  
 +
<b>
 
There should be NO use of the tab character!!!
 
There should be NO use of the tab character!!!
Each indent should be 3 blank spaces! I will write a wiki on how to set this up in VS 2008, VS 2010,And Notepad++
+
Each indent should be 3 blank spaces!</b>
 
 
 
 
  
</pre>
+
[http://zenit.senecac.on.ca/wiki/index.php/How_to_set_up_tab_spaces This] shows how to set up tab settings
  
 
<br /> <br />
 
<br /> <br />

Latest revision as of 17:11, 25 July 2010


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

HOTYS Homepage

Welcome to HOTYS homepage!!!

The Name of the team is derived from the first letter of each group member's name:

Han Chul Kim
Osman Mirza
Tony Kim
YuJin Jeong
Stephanie Law

Member List

OOP344 - 2010 Team HOTYS -
Last
Name
Name Seneca
Username
Section Blog Url IRC Nick My Contributions
a Kim Han hckim3 A http://hckim.wordpress.com/ han3 Hckim3
b Mirza Ozzy omirza A http://0zzym.wordpress.com/ OzZy_M OzZy
c Kim Tony(Kijeong) kjkim A My Blog TonyKim kjkim
d Jeong YuJin yjeong A Spirit & Soul _YJ_ Takeiteasy
e Law Stephanie slaw12 - A My Blog- Slaw12 slaw12


Project Development Page

Team Project

Discussions

Discussion Page


IRC Schedule/Log

  Group meetings will be held on Sundays at 12pm in #seneca-HOTYS.  
Logs:

  • Log 1 - This meeting mainly covered coding styles to be used and other group norms
  • Log 2 - This meeting mainly is us waiting for Fardad to show up. We later decided to split the functions and get to work since the assignment page was already up
  • Log 3 - This meeting we went over the simple functions and added v0.1 in tags as a group. Had some Borland Problems we fixed.
  • Log 4 - This meeting we went over the distribution list.
  • Log 5 - This meeting was focused on fixing bugs and committing to trunk in preparation of Fardad's test main
  • Log 6 - This meeting we distributed the project's work and created a rough time line for completion.
  • Log 7 - This meeting we put together all classes and went over bugs to fix and features to add. HOTYS - TextEdit v0.2 was committed to trunk


Coding Style Rules

Every file should have a function header with:

  • File name
  • Programmer Full name
  • Date last modified

Example:

  /*
Title
Title.h
By: Full Name
Date Last Modified: 9:59 AM April-15-10
Description of what is in the file
*/


Variable names should be meaningful so additional comments are not necessary to explain what the variable does.

Example:

  int nNum; //Bad
int nNumOfTypes //Good


A lower case prefix should be fitted to the variable name to help describe it at a glance:

Prefix Data Type Example
n int nNumOfSignals
c char cTypeMode
b boolean bIsTrue
f float fLength
d double dWidth
s C-Style null terminated string
OR a String object
sUserInput
p pointers pnNumOfSignals
m_ Data Member/
Instance Variable
m_pnNumOfSignals
NOT
pnm_NumOfSignals
OR
mpn_NumOfSignals

All variable declarations should be done on their own lines!

There should be NO single character names for variables (Ex: i, j, k, etc) except for arbitrary counters, such as for for loops

All const and #define Variable names should be in All Caps

Example:

  const int nMAX_TRIPS;
#define MAX_TRIPS 1



Pointers should be declared in C++ style:

Example:

  int* x;
NOT
int * x; OR int *x;


Class names should be all lower case except for the first letter, which should be upper case.

Function names should have meaningful names (They do not require prefix).

Function names Should be all lower case except for the First letter of each Word.

Example:

  GetChar();
NOT
getChar(); OR Getchar();



Each function should have only one point of entry and one point of exit! I.E. There should be only 1 return statement in each function.

Each function should have a header describing what it does.

Use Inline comments to describe hard to read code. All inline code should be set to the same indention as the code it is describing.

Example:

   //Comment
GetChar();
NOT
//Comment
GetChar()



Opening braces should be on the same line as the defining function/if/else if/etc statement.

Example:

  void FunctionOne(int){
if (x > y){
NOT
void FunctionOne(int)
{
if (x > y)
{

There should be NO use of the tab character!!! Each indent should be 3 blank spaces!

This shows how to set up tab settings