Improve docs.
1.1 --- a/doc/coding_style.dox Mon Nov 01 19:00:19 2004 +0000
1.2 +++ b/doc/coding_style.dox Tue Nov 02 06:28:38 2004 +0000
1.3 @@ -11,9 +11,35 @@
1.4 it. Please comply with these conventions if you want to contribute
1.5 developing LEMON library.
1.6
1.7 +\warning In some cases we diverge from these rules.
1.8 +This primary done because STL uses different naming convention and
1.9 +in certain cases
1.10 +it is beneficial to provide STL compatible interface.
1.11 +
1.12 +\subsection cs-files File Names
1.13 +
1.14 +The header file names should look like the following.
1.15 +
1.16 +\code
1.17 +header_file.h
1.18 +\endcode
1.19 +
1.20 +Note that all standard Lemon headers are located in the \c lemon subdirectory,
1.21 +so you should include them from C++ source like this:
1.22 +
1.23 +\code
1.24 +#include <lemon/header_file.h>
1.25 +\endcode
1.26 +
1.27 +The source code files use the same style and they have '.cc' extension.
1.28 +
1.29 +\code
1.30 +source_code.cc
1.31 +\endcode
1.32 +
1.33 \subsection cs-class Classes and other types
1.34
1.35 -The name of a class or any type should look like the following:
1.36 +The name of a class or any type should look like the following.
1.37
1.38 \code
1.39 AllWordsCapitalizedWithoutUnderscores
1.40 @@ -21,7 +47,7 @@
1.41
1.42 \subsection cs-func Methods and other functions
1.43
1.44 -The name of a function should look like the following:
1.45 +The name of a function should look like the following.
1.46
1.47 \code
1.48 firstWordLowerCaseRestCapitalizedWithoutUnderscores
1.49 @@ -29,7 +55,7 @@
1.50
1.51 \subsection cs-funcs Constants, Macros
1.52
1.53 -The names of constants and macros should look like the following:
1.54 +The names of constants and macros should look like the following.
1.55
1.56 \code
1.57 ALL_UPPER_CASE_WITH_UNDERSCORES
1.58 @@ -37,7 +63,7 @@
1.59
1.60 \subsection cs-loc-var Class and instance member variables, auto variables
1.61
1.62 -The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following:
1.63 +The names of class and instance member variables and auto variables (=variables used locally in methods) should look like the following.
1.64
1.65 \code
1.66 all_lower_case_with_underscores
1.67 @@ -45,15 +71,10 @@
1.68
1.69 \subsection cs-excep Exceptions
1.70
1.71 -When writing exceptions please comply the following naming conventions:
1.72 +When writing exceptions please comply the following naming conventions.
1.73
1.74 \code
1.75 ClassNameEndsWithException
1.76 \endcode
1.77
1.78 -\warning In some cases we diverge from these rules.
1.79 -This primary done because STL uses different naming convention and
1.80 -in certain cases
1.81 -it is beneficial to provide STL compatible interface.
1.82 -
1.83 */
2.1 --- a/doc/named-param.dox Mon Nov 01 19:00:19 2004 +0000
2.2 +++ b/doc/named-param.dox Tue Nov 02 06:28:38 2004 +0000
2.3 @@ -2,7 +2,12 @@
2.4
2.5 \page named-param Named Parameters
2.6
2.7 -\section named-templ-param Named Template Parameters
2.8 +\section named-func-param Named "Function" Parameters
2.9 +
2.10 +
2.11 +\section traits-classes Traits Classes
2.12 +
2.13 +\section named-templ-param Named Class Template Parameters
2.14
2.15 Instead of creating a new traits class you can also use this adaptor class
2.16 like this
2.17 @@ -15,5 +20,7 @@
2.18 Dijkstra<>::SetDistMap<MyMap>::SetPredMap<NullMap<Node,Edge> >
2.19 \endcode
2.20
2.21 +\section named-templ-func-param Named "Function" Template Parameters
2.22 +
2.23
2.24 */
3.1 --- a/src/work/alpar/dijkstra.h Mon Nov 01 19:00:19 2004 +0000
3.2 +++ b/src/work/alpar/dijkstra.h Tue Nov 02 06:28:38 2004 +0000
3.3 @@ -109,7 +109,7 @@
3.4 ///It is also possible to change the underlying priority heap.
3.5 ///
3.6 ///\param GR The graph type the algorithm runs on. The default value is
3.7 - ///\ref ListGraph. The value of GR is not used directly by %Dijsktra, it
3.8 + ///\ref ListGraph. The value of GR is not used directly by Dijkstra, it
3.9 ///is only passed to \ref DijkstraDefaultTraits.
3.10 ///\param LM This read-only
3.11 ///EdgeMap
3.12 @@ -118,11 +118,11 @@
3.13 ///may involve in relatively time consuming process to compute the edge
3.14 ///length if it is necessary. The default map type is
3.15 ///\ref skeleton::StaticGraph::EdgeMap "Graph::EdgeMap<int>".
3.16 - ///The value of LM is not used directly by %Dijsktra, it
3.17 + ///The value of LM is not used directly by Dijkstra, it
3.18 ///is only passed to \ref DijkstraDefaultTraits.
3.19 ///\param TR Traits class to set various data types used by the algorithm.
3.20 ///The default traits class is
3.21 - ///\ref DijkstraDefaultTraits<GR,LM> "DijkstraDefaultTraits<GR,LM>".
3.22 + ///\ref DijkstraDefaultTraits "DijkstraDefaultTraits<GR,LM>".
3.23 ///See \ref DijkstraDefaultTraits for the documentation of
3.24 ///a Dijkstra traits class.
3.25 ///