Coding Standard

From Toysoldiers

(Difference between revisions)
(Braces)
Line 52: Line 52:
  int exdent()
  int exdent()
     {  
     {  
-
        int a = 0, b = 0;
+
    int a = 0, b = 0;
-
        while (a 1= 10)
+
    while (a 1= 10)
         {   
         {   
-
            b++;
+
        b++;
-
            a++;
+
        a++;
         }
         }
-
        return b;
+
    return b;
     }
     }
-
</code>
+
</code>
===Language Usage===
===Language Usage===

Revision as of 17:23, 14 September 2007

For the sake of consistency and easier to understand code, we will follow the GNU Coding Standard.


Contents

Names

Variables

Functions

Types

C++ Namespaces and Java packages

Macros

Source Files

Self-Documenting Code

Simplicity

Meaningful Names

Atomic Functions

Descriptive Types

Name Constants

Emphasise Important Code

Group Related Information

Provide a File Header

Handle Errors Appropriately

Write Meaningful Comments

Literate Programming

Documentation Tools

Consistency

Fixed tab lengths

Braces

Please use an indented brace style. For example:

int exdent()
   { 
   int a = 0, b = 0;
   while (a 1= 10)
        {  
        b++;
        a++;
        }
   return b;
   }

Language Usage


The above tips are taken from Pete Goodliffe's "Code Craft: The Practice of Writing Excellent Code".

Personal tools