| author | marci |
| Tue, 17 Aug 2004 11:20:16 +0000 | |
| changeset 762 | 511200bdb71f |
| parent 628 | a3a53d7cedc2 |
| child 811 | e27135322727 |
| permissions | -rw-r--r-- |
| alpar@507 | 1 |
/*! |
| alpar@507 | 2 |
|
| alpar@509 | 3 |
\page coding_style Hugo Coding Style |
| alpar@507 | 4 |
|
| athos@603 | 5 |
\section Naming Conventions |
| alpar@507 | 6 |
|
| alpar@667 | 7 |
In order to make development easier we have made some conventions |
| alpar@667 | 8 |
according to coding style. These include names of types, classes, |
| alpar@667 | 9 |
functions, variables, constants and exceptions. If these conventions |
| alpar@667 | 10 |
are met in one's code then it is easier to read and maintain |
| alpar@667 | 11 |
it. Please comply with these conventions if you want to contribute |
| alpar@667 | 12 |
developing Hugo library. |
| athos@603 | 13 |
|
| alpar@614 | 14 |
\subsection cs-class Classes and other types |
| athos@603 | 15 |
|
| athos@603 | 16 |
The name of a class or any type should look like the following: |
| alpar@507 | 17 |
|
| alpar@507 | 18 |
\code |
| alpar@507 | 19 |
AllWordsCapitalizedWithoutUnderscores |
| alpar@507 | 20 |
\endcode |
| alpar@507 | 21 |
|
| alpar@614 | 22 |
\subsection cs-func Methods and other functions |
| athos@603 | 23 |
|
| athos@603 | 24 |
The name of a function should look like the following: |
| alpar@507 | 25 |
|
| alpar@507 | 26 |
\code |
| alpar@507 | 27 |
firstWordLowerCaseRestCapitalizedWithoutUnderscores |
| alpar@507 | 28 |
\endcode |
| alpar@507 | 29 |
|
| alpar@614 | 30 |
\subsection cs-funcs Constants, Macros |
| athos@603 | 31 |
|
| athos@603 | 32 |
The names of constants and macros should look like the following: |
| alpar@507 | 33 |
|
| alpar@507 | 34 |
\code |
| alpar@507 | 35 |
ALL_UPPER_CASE_WITH_UNDERSCORES |
| alpar@507 | 36 |
\endcode |
| alpar@507 | 37 |
|
| alpar@614 | 38 |
\subsection cs-loc-var Class and instance member variables, auto variables |
| alpar@507 | 39 |
|
| athos@603 | 40 |
The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following: |
| alpar@507 | 41 |
|
| alpar@507 | 42 |
\code |
| alpar@507 | 43 |
all_lower_case_with_underscores |
| alpar@507 | 44 |
\endcode |
| alpar@507 | 45 |
|
| alpar@614 | 46 |
\subsection cs-excep Exceptions |
| alpar@507 | 47 |
|
| athos@603 | 48 |
When writing exceptions please comply the following naming conventions: |
| athos@603 | 49 |
|
| alpar@507 | 50 |
\code |
| alpar@507 | 51 |
ClassNameEndsWithException |
| alpar@507 | 52 |
\endcode |
| alpar@507 | 53 |
|
| alpar@507 | 54 |
|
| alpar@507 | 55 |
*/ |