[Lemon-commits] Peter Kovacs: Doc reorganization + improvements
Lemon HG
hg at lemon.cs.elte.hu
Thu Oct 9 14:58:09 CEST 2008
details: http://lemon.cs.elte.hu/hg/lemon/rev/2cc60866a0c9
changeset: 314:2cc60866a0c9
user: Peter Kovacs <kpeter [at] inf.elte.hu>
date: Thu Oct 09 13:27:35 2008 +0200
description:
Doc reorganization + improvements
- Reorganize several tools (move them to other modules).
- Add new module for map concepts.
- Remove the doc of all tools in lemon/bits.
- Improvements in groups.dox.
- Fix some doxygen warnings.
diffstat:
17 files changed, 527 insertions(+), 558 deletions(-)
doc/groups.dox | 83 +++----
doc/mainpage.dox | 5
doc/migration.dox | 2
lemon/bits/alteration_notifier.h | 431 ++++++++++++++++++--------------------
lemon/bits/array_map.h | 168 +++++++-------
lemon/bits/base_extender.h | 34 +-
lemon/bits/bezier.h | 10
lemon/bits/default_map.h | 9
lemon/bits/enable_if.h | 24 +-
lemon/bits/graph_extender.h | 86 +++----
lemon/bits/map_extender.h | 16 -
lemon/bits/traits.h | 6
lemon/bits/vector_map.h | 170 +++++++-------
lemon/concepts/maps.h | 4
lemon/dim2.h | 19 -
lemon/maps.h | 14 -
lemon/time_measure.h | 4
diffs (truncated from 2025 to 300 lines):
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.
+
+<b>See also:</b> \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.
+
+<b>See also:</b> \ref map_concepts "Map Concepts".
*/
/**
@@ -86,7 +90,6 @@
This group describes maps that are specifically designed to assign
values to the nodes and arcs of graphs.
*/
-
/**
\defgroup map_adaptors Map Adaptors
@@ -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<int> 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
-
*/
/**
@@ -184,7 +186,6 @@
This group describes some data structures implemented in LEMON in
order to make it easier to implement combinatorial algorithms.
*/
-
/**
@defgroup algs 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).
*/
/**
- at defgroup shortest_path Shortest Path algorithms
+ at defgroup shortest_path Shortest Path Algorithms
@ingroup algs
\brief Algorithms for finding shortest paths.
@@ -213,7 +214,7 @@
*/
/**
- at defgroup max_flow Maximum Flow algorithms
+ at 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.
-
*/
/**
- at defgroup min_cost_flow Minimum Cost Flow algorithms
+ at defgroup min_cost_flow Minimum Cost Flow Algorithms
@ingroup algs
\brief Algorithms for finding minimum cost flows and circulations.
@@ -255,7 +255,7 @@
*/
/**
- at defgroup min_cut Minimum Cut algorithms
+ at 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".
-
*/
/**
- at defgroup graph_prop Connectivity and other graph properties
+ at defgroup graph_prop Connectivity and Other Graph Properties
@ingroup algs
\brief Algorithms for discovering the graph properties
@@ -298,7 +297,7 @@
*/
/**
- at defgroup planar Planarity embedding and drawing
+ at defgroup planar Planarity Embedding and Drawing
@ingroup algs
\brief Algorithms for planarity checking, embedding and drawing
@@ -310,7 +309,7 @@
*/
/**
- at defgroup matching Matching algorithms
+ at 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
-
*/
/**
- at defgroup spantree Minimum Spanning Tree algorithms
+ at 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
*/
-
/**
- at defgroup auxalg Auxiliary algorithms
+ at defgroup auxalg Auxiliary Algorithms
@ingroup algs
\brief Auxiliary algorithms implemented in LEMON.
@@ -371,7 +368,8 @@
*/
/**
- at defgroup approx Approximation algorithms
+ at defgroup approx Approximation Algorithms
+ at 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.
-
*/
/**
- at defgroup lp_group Lp and Mip solvers
+ at 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.
-
*/
/**
- at defgroup lp_utils Tools for Lp and Mip solvers
+ at defgroup lp_utils Tools for Lp and Mip Solvers
@ingroup lp_group
\brief Helper tools to the Lp and Mip solvers.
@@ -441,21 +437,12 @@
*/
/**
- at defgroup timecount Time measuring and Counting
+ at defgroup timecount Time Measuring and Counting
@ingroup misc
\brief Simple tools for measuring the performance of algorithms.
This group describes simple tools for measuring the performance
of algorithms.
-*/
-
-/**
- at defgroup graphbits Tools for Graph Implementation
- at 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.
*/
/**
@@ -471,28 +458,28 @@
\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".
*/
/**
- at defgroup eps_io Postscript exporting
+ at defgroup eps_io Postscript Exporting
@ingroup io_group
\brief General \c EPS drawer and graph exporter
This group describes general \c EPS drawing methods and special
graph exporting tools.
*/
-
/**
@defgroup concept Concepts
@@ -521,9 +508,7 @@
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
@@ -534,10 +519,12 @@
graph structures and helper classes used to implement these.
*/
-/* --- Unused group
- at defgroup experimental Experimental Structures and Algorithms
-This group describes some Experimental structures and algorithms.
-The stuff here is subject to change.
+/**
+ at defgroup map_concepts Map Concepts
+ at ingroup concept
+\brief Skeleton and concept checking classes for maps
+
+This group describes the skeletons and concept checking classes of maps.
*/
/**
diff -r 64f8f7cc6168 -r 2cc60866a0c9 doc/mainpage.dox
--- a/doc/mainpage.dox Thu Oct 09 10:09:44 2008 +0200
+++ b/doc/mainpage.dox Thu Oct 09 13:27:35 2008 +0200
@@ -50,11 +50,12 @@
If you
More information about the Lemon-commits
mailing list