I completed the description of the coding style.
authorathos
Tue, 11 May 2004 09:30:06 +0000
changeset 60386458ad390a7
parent 602 580b329c2a0c
child 604 4acd273c3009
I completed the description of the coding style.
doc/coding_style.dox
     1.1 --- a/doc/coding_style.dox	Mon May 10 16:59:20 2004 +0000
     1.2 +++ b/doc/coding_style.dox	Tue May 11 09:30:06 2004 +0000
     1.3 @@ -2,35 +2,37 @@
     1.4  
     1.5  \page coding_style Hugo Coding Style 
     1.6  
     1.7 -\todo More detailed description, an introductory paragraph, etc.
     1.8 - 
     1.9 -\section Naming Convenions
    1.10 +\section Naming Conventions
    1.11  
    1.12 -\subsection Classes
    1.13 +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. 
    1.14 +
    1.15 +\subsection Classes and other types
    1.16 +
    1.17 +The name of a class or any type should look like the following:
    1.18  
    1.19  \code
    1.20  AllWordsCapitalizedWithoutUnderscores 
    1.21  \endcode
    1.22  
    1.23 -\subsection Methods
    1.24 +\subsection Methods and other functions
    1.25 +
    1.26 +The name of a function should look like the following:
    1.27  
    1.28  \code
    1.29  firstWordLowerCaseRestCapitalizedWithoutUnderscores 
    1.30  \endcode
    1.31  
    1.32 -\subsection Constants
    1.33 +\subsection Constants, Macros
    1.34 +
    1.35 +The names of constants and macros should look like the following:
    1.36  
    1.37  \code
    1.38  ALL_UPPER_CASE_WITH_UNDERSCORES 
    1.39  \endcode
    1.40  
    1.41 -\subsection %Class and instance member variables
    1.42 +\subsection Class and instance member variables, auto variables 
    1.43  
    1.44 -\code
    1.45 -all_lower_case_with_underscores 
    1.46 -\endcode
    1.47 -
    1.48 -\subsection Auto variables (=variables used locally in methods)
    1.49 +The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following:
    1.50  
    1.51  \code
    1.52  all_lower_case_with_underscores 
    1.53 @@ -38,6 +40,8 @@
    1.54  
    1.55  \subsection Exceptions
    1.56  
    1.57 +When writing exceptions please comply the following naming conventions:
    1.58 +
    1.59  \code
    1.60  ClassNameEndsWithException
    1.61  \endcode