diff -r 64f8f7cc6168 -r 2cc60866a0c9 doc/groups.dox --- a/doc/groups.dox Thu Oct 09 10:09:44 2008 +0200 +++ b/doc/groups.dox Thu Oct 09 13:27:35 2008 +0200 @@ -54,7 +54,9 @@ You are free to use the graph structure that fit your requirements the best, most graph algorithms and auxiliary data structures can be used -with any graph structures. +with any graph structure. + +See also: \ref graph_concepts "Graph Structure Concepts". */ /** @@ -74,8 +76,10 @@ This group describes the map structures implemented in LEMON. -LEMON provides several special purpose maps that e.g. combine +LEMON provides several special purpose maps and map adaptors that e.g. combine new maps from existing ones. + +See also: \ref map_concepts "Map Concepts". */ /** @@ -87,7 +91,6 @@ values to the nodes and arcs of graphs. */ - /** \defgroup map_adaptors Map Adaptors \ingroup maps @@ -104,7 +107,7 @@ The typical usage of this classes is passing implicit maps to algorithms. If a function type algorithm is called then the function type map adaptors can be used comfortable. For example let's see the -usage of map adaptors with the \c digraphToEps() function. +usage of map adaptors with the \c graphToEps() function. \code Color nodeColor(int deg) { if (deg >= 2) { @@ -118,13 +121,13 @@ Digraph::NodeMap degree_map(graph); - digraphToEps(graph, "graph.eps") + graphToEps(graph, "graph.eps") .coords(coords).scaleToA4().undirected() .nodeColors(composeMap(functorToMap(nodeColor), degree_map)) .run(); \endcode The \c functorToMap() function makes an \c int to \c Color map from the -\e nodeColor() function. The \c composeMap() compose the \e degree_map +\c nodeColor() function. The \c composeMap() compose the \c degree_map and the previously created map. The composed map is a proper function to get the color of each node. @@ -173,7 +176,6 @@ any kind of path structure. \sa lemon::concepts::Path - */ /** @@ -185,7 +187,6 @@ order to make it easier to implement combinatorial algorithms. */ - /** @defgroup algs Algorithms \brief This group describes the several algorithms @@ -201,11 +202,11 @@ \brief Common graph search algorithms. This group describes the common graph search algorithms like -Breadth-first search (Bfs) and Depth-first search (Dfs). +Breadth-First Search (BFS) and Depth-First Search (DFS). */ /** -@defgroup shortest_path Shortest Path algorithms +@defgroup shortest_path Shortest Path Algorithms @ingroup algs \brief Algorithms for finding shortest paths. @@ -213,7 +214,7 @@ */ /** -@defgroup max_flow Maximum Flow algorithms +@defgroup max_flow Maximum Flow Algorithms @ingroup algs \brief Algorithms for finding maximum flows. @@ -241,11 +242,10 @@ fastest method to compute the maximum flow. All impelementations provides functions to query the minimum cut, which is the dual linear programming problem of the maximum flow. - */ /** -@defgroup min_cost_flow Minimum Cost Flow algorithms +@defgroup min_cost_flow Minimum Cost Flow Algorithms @ingroup algs \brief Algorithms for finding minimum cost flows and circulations. @@ -255,7 +255,7 @@ */ /** -@defgroup min_cut Minimum Cut algorithms +@defgroup min_cut Minimum Cut Algorithms @ingroup algs \brief Algorithms for finding minimum cut in graphs. @@ -282,11 +282,10 @@ If you want to find minimum cut just between two distinict nodes, please see the \ref max_flow "Maximum Flow page". - */ /** -@defgroup graph_prop Connectivity and other graph properties +@defgroup graph_prop Connectivity and Other Graph Properties @ingroup algs \brief Algorithms for discovering the graph properties @@ -298,7 +297,7 @@ */ /** -@defgroup planar Planarity embedding and drawing +@defgroup planar Planarity Embedding and Drawing @ingroup algs \brief Algorithms for planarity checking, embedding and drawing @@ -310,7 +309,7 @@ */ /** -@defgroup matching Matching algorithms +@defgroup matching Matching Algorithms @ingroup algs \brief Algorithms for finding matchings in graphs and bipartite graphs. @@ -348,11 +347,10 @@ \image html bipartite_matching.png \image latex bipartite_matching.eps "Bipartite Matching" width=\textwidth - */ /** -@defgroup spantree Minimum Spanning Tree algorithms +@defgroup spantree Minimum Spanning Tree Algorithms @ingroup algs \brief Algorithms for finding a minimum cost spanning tree in a graph. @@ -360,9 +358,8 @@ tree in a graph */ - /** -@defgroup auxalg Auxiliary algorithms +@defgroup auxalg Auxiliary Algorithms @ingroup algs \brief Auxiliary algorithms implemented in LEMON. @@ -371,7 +368,8 @@ */ /** -@defgroup approx Approximation algorithms +@defgroup approx Approximation Algorithms +@ingroup algs \brief Approximation algorithms. This group describes the approximation and heuristic algorithms @@ -385,22 +383,20 @@ This group describes some general optimization frameworks implemented in LEMON. - */ /** -@defgroup lp_group Lp and Mip solvers +@defgroup lp_group Lp and Mip Solvers @ingroup gen_opt_group \brief Lp and Mip solver interfaces for LEMON. This group describes Lp and Mip solver interfaces for LEMON. The various LP solvers could be used in the same manner with this interface. - */ /** -@defgroup lp_utils Tools for Lp and Mip solvers +@defgroup lp_utils Tools for Lp and Mip Solvers @ingroup lp_group \brief Helper tools to the Lp and Mip solvers. @@ -441,7 +437,7 @@ */ /** -@defgroup timecount Time measuring and Counting +@defgroup timecount Time Measuring and Counting @ingroup misc \brief Simple tools for measuring the performance of algorithms. @@ -450,15 +446,6 @@ */ /** -@defgroup graphbits Tools for Graph Implementation -@ingroup utils -\brief Tools to make it easier to create graphs. - -This group describes the tools that makes it easier to create graphs and -the maps that dynamically update with the graph changes. -*/ - -/** @defgroup exceptions Exceptions @ingroup utils \brief Exceptions defined in LEMON. @@ -471,21 +458,22 @@ \brief Graph Input-Output methods This group describes the tools for importing and exporting graphs -and graph related data. Now it supports the LEMON format, the -\c DIMACS format and the encapsulated postscript (EPS) format. +and graph related data. Now it supports the \ref lgf-format +"LEMON Graph Format", the \c DIMACS format and the encapsulated +postscript (EPS) format. */ /** @defgroup lemon_io LEMON Input-Output @ingroup io_group -\brief Reading and writing \ref lgf-format "LEMON Graph Format". +\brief Reading and writing LEMON Graph Format. This group describes methods for reading and writing \ref lgf-format "LEMON Graph Format". */ /** -@defgroup eps_io Postscript exporting +@defgroup eps_io Postscript Exporting @ingroup io_group \brief General \c EPS drawer and graph exporter @@ -493,7 +481,6 @@ graph exporting tools. */ - /** @defgroup concept Concepts \brief Skeleton classes and concept checking classes @@ -521,10 +508,8 @@ concept indeed provides all the required features. - Finally, They can serve as a skeleton of a new implementation of a concept. - */ - /** @defgroup graph_concepts Graph Structure Concepts @ingroup concept @@ -534,10 +519,12 @@ graph structures and helper classes used to implement these. */ -/* --- Unused group -@defgroup experimental Experimental Structures and Algorithms -This group describes some Experimental structures and algorithms. -The stuff here is subject to change. +/** +@defgroup map_concepts Map Concepts +@ingroup concept +\brief Skeleton and concept checking classes for maps + +This group describes the skeletons and concept checking classes of maps. */ /**