lemon-1.1: doc/coding_style.dox@660db48f324f

     1 /* -*- mode: C++; indent-tabs-mode: nil; -*-

     2  *

     3  * This file is a part of LEMON, a generic C++ optimization library.

     4  *

     5  * Copyright (C) 2003-2008

     6  * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport

     7  * (Egervary Research Group on Combinatorial Optimization, EGRES).

     8  *

     9  * Permission to use, modify and distribute this software is granted

    10  * provided that this copyright notice appears in all copies. For

    11  * precise terms see the accompanying LICENSE file.

    12  *

    13  * This software is provided "AS IS" with no warranty of any kind,

    14  * express or implied, and with no claim as to its suitability for any

    15  * purpose.

    16  *

    17  */

    19 /*!

    21 \page coding_style LEMON Coding Style

    23 \section naming_conv Naming Conventions

    25 In order to make development easier we have made some conventions

    26 according to coding style. These include names of types, classes,

    27 functions, variables, constants and exceptions. If these conventions

    28 are met in one's code then it is easier to read and maintain

    29 it. Please comply with these conventions if you want to contribute

    30 developing LEMON library.

    32 \note When the coding style requires the capitalization of an abbreviation,

    33 only the first letter should be upper case.

    35 \code

    36 XmlReader

    37 \endcode

    40 \warning In some cases we diverge from these rules.

    41 This is primary done because STL uses different naming convention and

    42 in certain cases

    43 it is beneficial to provide STL compatible interface.

    45 \subsection cs-files File Names

    47 The header file names should look like the following.

    49 \code

    50 header_file.h

    51 \endcode

    53 Note that all standard LEMON headers are located in the \c lemon subdirectory,

    54 so you should include them from C++ source like this:

    56 \code

    57 #include <lemon/header_file.h>

    58 \endcode

    60 The source code files use the same style and they have '.cc' extension.

    62 \code

    63 source_code.cc

    64 \endcode

    66 \subsection cs-class Classes and other types

    68 The name of a class or any type should look like the following.

    70 \code

    71 AllWordsCapitalizedWithoutUnderscores

    72 \endcode

    74 \subsection cs-func Methods and other functions

    76 The name of a function should look like the following.

    78 \code

    79 firstWordLowerCaseRestCapitalizedWithoutUnderscores

    80 \endcode

    82 \subsection cs-funcs Constants, Macros

    84 The names of constants and macros should look like the following.

    86 \code

    87 ALL_UPPER_CASE_WITH_UNDERSCORES

    88 \endcode

    90 \subsection cs-loc-var Class and instance member variables, auto variables

    92 The names of class and instance member variables and auto variables

    93 (=variables used locally in methods) should look like the following.

    95 \code

    96 all_lower_case_with_underscores

    97 \endcode

    99 \subsection pri-loc-var Private member variables

   101 Private member variables should start with underscore

   103 \code

   104 _start_with_underscores

   105 \endcode

   107 \subsection cs-excep Exceptions

   109 When writing exceptions please comply the following naming conventions.

   111 \code

   112 ClassNameEndsWithException

   113 \endcode

   115 or

   117 \code

   118 ClassNameEndsWithError

   119 \endcode

   121 \section header-template Template Header File

   123 Each LEMON header file should look like this:

   125 \include template.h

   127 */

author	Alpar Juttner <alpar@cs.elte.hu>
	Fri, 21 Nov 2008 14:11:29 +0000
changeset 389	660db48f324f
parent 209	765619b7cbb2
child 440	88ed40ad0d4f
permissions	-rw-r--r--