[Lemon-commits] Peter Kovacs: Using \tparam commands + removing ...
Lemon HG
hg at lemon.cs.elte.hu
Sun May 25 12:17:02 CEST 2008
details: http://lemon.cs.elte.hu/hg/lemon/rev/2ccc1afc2c52
changeset: 157:2ccc1afc2c52
user: Peter Kovacs <kpeter [at] inf.elte.hu>
date: Sat May 24 23:20:49 2008 +0200
description:
Using \tparam commands + removing \author commands (ticket #29, #39)
diffstat:
14 files changed, 47 insertions(+), 77 deletions(-)
lemon/bfs.h | 20 ++++++++------------
lemon/bin_heap.h | 6 +++---
lemon/bits/alteration_notifier.h | 4 ----
lemon/bits/bezier.h | 2 --
lemon/bits/vector_map.h | 9 ++++-----
lemon/color.h | 2 --
lemon/concepts/path.h | 4 ++--
lemon/dfs.h | 18 ++++++++----------
lemon/dijkstra.h | 17 ++++++++---------
lemon/graph_to_eps.h | 4 ++--
lemon/graph_utils.h | 24 ++++++++----------------
lemon/path.h | 8 ++++----
lemon/smart_graph.h | 2 --
lemon/time_measure.h | 4 ----
diffs (truncated from 492 to 300 lines):
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/bfs.h
--- a/lemon/bfs.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/bfs.h Sat May 24 23:20:49 2008 +0200
@@ -37,7 +37,7 @@
///Default traits class of Bfs class.
///Default traits class of Bfs class.
- ///\param GR Digraph type.
+ ///\tparam GR Digraph type.
template<class GR>
struct BfsDefaultTraits
{
@@ -115,16 +115,14 @@
///\ingroup search
///This class provides an efficient implementation of the %BFS algorithm.
///
- ///\param GR The digraph type the algorithm runs on. The default value is
+ ///\tparam GR The digraph type the algorithm runs on. The default value is
///\ref ListDigraph. The value of GR is not used directly by Bfs, it
///is only passed to \ref BfsDefaultTraits.
- ///\param TR Traits class to set various data types used by the algorithm.
+ ///\tparam TR Traits class to set various data types used by the algorithm.
///The default traits class is
///\ref BfsDefaultTraits "BfsDefaultTraits<GR>".
///See \ref BfsDefaultTraits for the documentation of
///a Bfs traits class.
- ///
- ///\author Alpar Juttner
#ifdef DOXYGEN
template <typename GR,
@@ -756,7 +754,7 @@
///Default traits class of Bfs function.
///Default traits class of Bfs function.
- ///\param GR Digraph type.
+ ///\tparam GR Digraph type.
template<class GR>
struct BfsWizardDefaultTraits
{
@@ -1165,7 +1163,7 @@
/// \brief Default traits class of BfsVisit class.
///
/// Default traits class of BfsVisit class.
- /// \param _Digraph Digraph type.
+ /// \tparam _Digraph Digraph type.
template<class _Digraph>
struct BfsVisitDefaultTraits {
@@ -1201,20 +1199,18 @@
/// class. It works with callback mechanism, the BfsVisit object calls
/// on every bfs event the \c Visitor class member functions.
///
- /// \param _Digraph The digraph type the algorithm runs on. The default value is
+ /// \tparam _Digraph The digraph type the algorithm runs on. The default value is
/// \ref ListDigraph. The value of _Digraph is not used directly by Bfs, it
/// is only passed to \ref BfsDefaultTraits.
- /// \param _Visitor The Visitor object for the algorithm. The
+ /// \tparam _Visitor The Visitor object for the algorithm. The
/// \ref BfsVisitor "BfsVisitor<_Digraph>" is an empty Visitor which
/// does not observe the Bfs events. If you want to observe the bfs
/// events you should implement your own Visitor class.
- /// \param _Traits Traits class to set various data types used by the
+ /// \tparam _Traits Traits class to set various data types used by the
/// algorithm. The default traits class is
/// \ref BfsVisitDefaultTraits "BfsVisitDefaultTraits<_Digraph>".
/// See \ref BfsVisitDefaultTraits for the documentation of
/// a Bfs visit traits class.
- ///
- /// \author Jacint Szabo, Alpar Juttner and Balazs Dezso
#ifdef DOXYGEN
template <typename _Digraph, typename _Visitor, typename _Traits>
#else
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/bin_heap.h
--- a/lemon/bin_heap.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/bin_heap.h Sat May 24 23:20:49 2008 +0200
@@ -39,10 +39,10 @@
///efficient. \c Compare specifies the ordering of the priorities. In a heap
///one can change the priority of an item, add or erase an item, etc.
///
- ///\param _Prio Type of the priority of the items.
- ///\param _ItemIntMap A read and writable Item int map, used internally
+ ///\tparam _Prio Type of the priority of the items.
+ ///\tparam _ItemIntMap A read and writable Item int map, used internally
///to handle the cross references.
- ///\param _Compare A class for the ordering of the priorities. The
+ ///\tparam _Compare A class for the ordering of the priorities. The
///default is \c std::less<_Prio>.
///
///\sa FibHeap
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/bits/alteration_notifier.h
--- a/lemon/bits/alteration_notifier.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/bits/alteration_notifier.h Sat May 24 23:20:49 2008 +0200
@@ -94,8 +94,6 @@
///
/// \param _Container The container which is observed.
/// \param _Item The item type which is obserbved.
- ///
- /// \author Balazs Dezso
template <typename _Container, typename _Item>
class AlterationNotifier {
@@ -130,8 +128,6 @@
/// The build() and clear() members are to notify the observer
/// about the container is built from an empty container or
/// is cleared to an empty container.
- ///
- /// \author Balazs Dezso
class ObserverBase {
protected:
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/bits/bezier.h
--- a/lemon/bits/bezier.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/bits/bezier.h Sat May 24 23:20:49 2008 +0200
@@ -24,8 +24,6 @@
///\brief Classes to compute with Bezier curves.
///
///Up to now this file is used internally by \ref graph_to_eps.h
-///
-///\author Alpar Juttner
#include<lemon/dim2.h>
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/bits/vector_map.h
--- a/lemon/bits/vector_map.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/bits/vector_map.h Sat May 24 23:20:49 2008 +0200
@@ -44,11 +44,10 @@
/// automatically updates the map when a key is added to or erased from
/// the map. This map type uses the std::vector to store the values.
///
- /// \param Notifier The AlterationNotifier that will notify this map.
- /// \param Item The item type of the graph items.
- /// \param Value The value type of the map.
- ///
- /// \author Balazs Dezso
+ /// \tparam _Notifier The AlterationNotifier that will notify this map.
+ /// \tparam _Item The item type of the graph items.
+ /// \tparam _Value The value type of the map.
+ /// \todo Fix the doc: there is _Graph parameter instead of _Notifier.
template <typename _Graph, typename _Item, typename _Value>
class VectorMap
: public ItemSetTraits<_Graph, _Item>::ItemNotifier::ObserverBase {
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/color.h
--- a/lemon/color.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/color.h Sat May 24 23:20:49 2008 +0200
@@ -27,8 +27,6 @@
///\ingroup misc
///\file
///\brief Tools to manage RGB colors.
-///
-///\author Alpar Juttner
namespace lemon {
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/concepts/path.h
--- a/lemon/concepts/path.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/concepts/path.h Sat May 24 23:20:49 2008 +0200
@@ -40,7 +40,7 @@
///
/// A skeleton structure for representing directed paths in a
/// digraph.
- /// \param _Digraph The digraph type in which the path is.
+ /// \tparam _Digraph The digraph type in which the path is.
///
/// In a sense, the path can be treated as a list of arcs. The
/// lemon path type stores just this list. As a consequence it
@@ -205,7 +205,7 @@
/// assigned to a real path and the dumpers can be implemented as
/// an adaptor class to the predecessor map.
- /// \param _Digraph The digraph type in which the path is.
+ /// \tparam _Digraph The digraph type in which the path is.
///
/// The paths can be constructed from any path type by a
/// template constructor or a template assignment operator.
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/dfs.h
--- a/lemon/dfs.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/dfs.h Sat May 24 23:20:49 2008 +0200
@@ -38,7 +38,7 @@
///Default traits class of Dfs class.
///Default traits class of Dfs class.
- ///\param GR Digraph type.
+ ///\tparam GR Digraph type.
template<class GR>
struct DfsDefaultTraits
{
@@ -117,16 +117,14 @@
///\ingroup search
///This class provides an efficient implementation of the %DFS algorithm.
///
- ///\param GR The digraph type the algorithm runs on. The default value is
+ ///\tparam GR The digraph type the algorithm runs on. The default value is
///\ref ListDigraph. The value of GR is not used directly by Dfs, it
///is only passed to \ref DfsDefaultTraits.
- ///\param TR Traits class to set various data types used by the algorithm.
+ ///\tparam TR Traits class to set various data types used by the algorithm.
///The default traits class is
///\ref DfsDefaultTraits "DfsDefaultTraits<GR>".
///See \ref DfsDefaultTraits for the documentation of
///a Dfs traits class.
- ///
- ///\author Jacint Szabo and Alpar Juttner
#ifdef DOXYGEN
template <typename GR,
typename TR>
@@ -739,7 +737,7 @@
///Default traits class of Dfs function.
///Default traits class of Dfs function.
- ///\param GR Digraph type.
+ ///\tparam GR Digraph type.
template<class GR>
struct DfsWizardDefaultTraits
{
@@ -1160,7 +1158,7 @@
/// \brief Default traits class of DfsVisit class.
///
/// Default traits class of DfsVisit class.
- /// \param _Digraph Digraph type.
+ /// \tparam _Digraph Digraph type.
template<class _Digraph>
struct DfsVisitDefaultTraits {
@@ -1195,14 +1193,14 @@
/// class. It works with callback mechanism, the DfsVisit object calls
/// on every dfs event the \c Visitor class member functions.
///
- /// \param _Digraph The digraph type the algorithm runs on. The default value is
+ /// \tparam _Digraph The digraph type the algorithm runs on. The default value is
/// \ref ListDigraph. The value of _Digraph is not used directly by Dfs, it
/// is only passed to \ref DfsDefaultTraits.
- /// \param _Visitor The Visitor object for the algorithm. The
+ /// \tparam _Visitor The Visitor object for the algorithm. The
/// \ref DfsVisitor "DfsVisitor<_Digraph>" is an empty Visitor which
/// does not observe the Dfs events. If you want to observe the dfs
/// events you should implement your own Visitor class.
- /// \param _Traits Traits class to set various data types used by the
+ /// \tparam _Traits Traits class to set various data types used by the
/// algorithm. The default traits class is
/// \ref DfsVisitDefaultTraits "DfsVisitDefaultTraits<_Digraph>".
/// See \ref DfsVisitDefaultTraits for the documentation of
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/dijkstra.h
--- a/lemon/dijkstra.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/dijkstra.h Sat May 24 23:20:49 2008 +0200
@@ -77,8 +77,8 @@
///Default traits class of Dijkstra class.
///Default traits class of Dijkstra class.
- ///\param GR Digraph type.
- ///\param LM Type of length map.
+ ///\tparam GR Digraph type.
+ ///\tparam LM Type of length map.
template<class GR, class LM>
struct DijkstraDefaultTraits
{
@@ -194,23 +194,22 @@
///
///It is also possible to change the underlying priority heap.
///
- ///\param GR The digraph type the algorithm runs on. The default value
+ ///\tparam GR The digraph type the algorithm runs on. The default value
///is \ref ListDigraph. The value of GR is not used directly by
///Dijkstra, it is only passed to \ref DijkstraDefaultTraits.
- ///\param LM This read-only ArcMap determines the lengths of the
+ ///\tparam LM This read-only ArcMap determines the lengths of the
///arcs. It is read once for each arc, so the map may involve in
///relatively time consuming process to compute the arc length if
///it is necessary. The default map type is \ref
///concepts::Digraph::ArcMap "Digraph::ArcMap<int>". The value
///of LM is not used directly by Dijkstra, it is only passed to \ref
- ///DijkstraDefaultTraits. \param TR Traits class to set
+ ///DijkstraDefaultTraits.
+ ///\tparam TR Traits class to set
///various data types used by the algorithm. The default traits
///class is \ref DijkstraDefaultTraits
///"DijkstraDefaultTraits<GR,LM>". See \ref
///DijkstraDefaultTraits for the documentation of a Dijkstra traits
///class.
- ///
- ///\author Jacint Szabo and Alpar Juttner
#ifdef DOXYGEN
template <typename GR, typename LM, typename TR>
@@ -875,8 +874,8 @@
///Default traits class of Dijkstra function.
///Default traits class of Dijkstra function.
- ///\param GR Digraph type.
- ///\param LM Type of length map.
+ ///\tparam GR Digraph type.
+ ///\tparam LM Type of length map.
template<class GR, class LM>
struct DijkstraWizardDefaultTraits
{
diff -r e561aa7675de -r 2ccc1afc2c52 lemon/graph_to_eps.h
--- a/lemon/graph_to_eps.h Sat May 17 06:30:02 2008 +0100
+++ b/lemon/graph_to_eps.h Sat May 24 23:20:49 2008 +0200
@@ -416,7 +416,7 @@
///Sets the map of the arc widths
More information about the Lemon-commits
mailing list