doc/coding_style.dox
changeset 614 75cf1d52eee5
parent 603 86458ad390a7
child 628 a3a53d7cedc2
equal deleted inserted replaced
2:d3edd44514db 3:7485312fd58d
     4 
     4 
     5 \section Naming Conventions
     5 \section Naming Conventions
     6 
     6 
     7 In order to make development easier we have made some conventions according to coding style. These include names of types, classes, functions, variables, constants and exceptions. If these conventions are met in one's code then it is easier to read and maintain it. Please comply with these conventions if you want to contribute developing Hugo library. 
     7 In order to make development easier we have made some conventions according to coding style. These include names of types, classes, functions, variables, constants and exceptions. If these conventions are met in one's code then it is easier to read and maintain it. Please comply with these conventions if you want to contribute developing Hugo library. 
     8 
     8 
     9 \subsection Classes and other types
     9 \subsection cs-class Classes and other types
    10 
    10 
    11 The name of a class or any type should look like the following:
    11 The name of a class or any type should look like the following:
    12 
    12 
    13 \code
    13 \code
    14 AllWordsCapitalizedWithoutUnderscores 
    14 AllWordsCapitalizedWithoutUnderscores 
    15 \endcode
    15 \endcode
    16 
    16 
    17 \subsection Methods and other functions
    17 \subsection cs-func Methods and other functions
    18 
    18 
    19 The name of a function should look like the following:
    19 The name of a function should look like the following:
    20 
    20 
    21 \code
    21 \code
    22 firstWordLowerCaseRestCapitalizedWithoutUnderscores 
    22 firstWordLowerCaseRestCapitalizedWithoutUnderscores 
    23 \endcode
    23 \endcode
    24 
    24 
    25 \subsection Constants, Macros
    25 \subsection cs-funcs Constants, Macros
    26 
    26 
    27 The names of constants and macros should look like the following:
    27 The names of constants and macros should look like the following:
    28 
    28 
    29 \code
    29 \code
    30 ALL_UPPER_CASE_WITH_UNDERSCORES 
    30 ALL_UPPER_CASE_WITH_UNDERSCORES 
    31 \endcode
    31 \endcode
    32 
    32 
    33 \subsection Class and instance member variables, auto variables 
    33 \subsection cs-loc-var Class and instance member variables, auto variables 
    34 
    34 
    35 The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following:
    35 The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following:
    36 
    36 
    37 \code
    37 \code
    38 all_lower_case_with_underscores 
    38 all_lower_case_with_underscores 
    39 \endcode
    39 \endcode
    40 
    40 
    41 \subsection Exceptions
    41 \subsection cs-excep Exceptions
    42 
    42 
    43 When writing exceptions please comply the following naming conventions:
    43 When writing exceptions please comply the following naming conventions:
    44 
    44 
    45 \code
    45 \code
    46 ClassNameEndsWithException
    46 ClassNameEndsWithException