COIN-OR::LEMON - Graph Library

Changeset 313:64f8f7cc6168 in lemon-1.2 for lemon


Ignore:
Timestamp:
10/09/08 10:09:44 (15 years ago)
Author:
Peter Kovacs <kpeter@…>
Branch:
default
Phase:
public
Message:

Fix several doxygen warnings

Location:
lemon
Files:
14 edited

Legend:

Unmodified
Added
Removed
  • lemon/bits/alteration_notifier.h

    r236 r313  
    8080  /// be rolled back by calling the \e erase() or \e clear()
    8181  /// functions. Thence the \e erase() and \e clear() should not throw
    82   /// exception. Actullay, it can be throw only
    83   /// \ref AlterationObserver::ImmediateDetach ImmediateDetach
     82  /// exception. Actullay, it can be throw only \ref ImmediateDetach
    8483  /// exception which detach the observer from the notifier.
    8584  ///
  • lemon/bits/default_map.h

    r209 r313  
    150150// #endif
    151151
    152   /// \e
     152  /// DefaultMap class
    153153  template <typename _Graph, typename _Item, typename _Value>
    154154  class DefaultMap
  • lemon/color.h

    r209 r313  
    9393  extern const Color DARK_CYAN;
    9494
    95   ///Map <tt>int</tt>s to different \ref Color "Color"s
     95  ///Map <tt>int</tt>s to different <tt>Color</tt>s
    9696
    9797  ///This map assigns one of the predefined \ref Color "Color"s to
  • lemon/concepts/graph_components.h

    r263 r313  
    983983    ///
    984984    /// This class describes the common interface of the graph maps
    985     /// (NodeMap, ArcMap), that is \ref maps-page "maps" which can be used to
     985    /// (NodeMap, ArcMap), that is maps that can be used to
    986986    /// associate data to graph descriptors (nodes or arcs).
    987987    template <typename _Graph, typename _Item, typename _Value>
  • lemon/core.h

    r300 r313  
    15551555    ///structure is updated after each graph alteration. Thus although
    15561556    ///this data structure is theoretically faster than \ref ArcLookUp
    1557     ///and \ref AllArcLookup, it often provides worse performance than
     1557    ///and \ref AllArcLookUp, it often provides worse performance than
    15581558    ///them.
    15591559    Arc operator()(Node s, Node t, Arc p = INVALID) const  {
     
    17001700    ///Find an arc between two nodes.
    17011701
    1702     ///Find an arc between two nodes in time <em>O</em>(log<em>d</em>), where
    1703     ///<em>d</em> is the number of outgoing arcs of \c s.
     1702    ///Find an arc between two nodes in time <em>O</em>(log<em>d</em>),
     1703    ///where <em>d</em> is the number of outgoing arcs of \c s.
    17041704    ///\param s The source node.
    17051705    ///\param t The target node.
     
    18181818    ///\endcode
    18191819    ///
    1820     ///Finding the first arc take <em>O</em>(log<em>d</em>) time, where
    1821     ///<em>d</em> is the number of outgoing arcs of \c s. Then, the
     1820    ///Finding the first arc take <em>O</em>(log<em>d</em>) time,
     1821    ///where <em>d</em> is the number of outgoing arcs of \c s. Then the
    18221822    ///consecutive arcs are found in constant time.
    18231823    ///
  • lemon/dfs.h

    r301 r313  
    836836  };
    837837
    838   /// Default traits class used by \ref DfsWizard
     838  /// Default traits class used by DfsWizard
    839839
    840840  /// To make it easier to use Dfs algorithm
  • lemon/dijkstra.h

    r301 r313  
    454454
    455455    /// \brief \ref named-templ-param "Named parameter" for setting
    456     ///\ref OperationTraits type
     456    ///\c OperationTraits type
    457457    ///
    458458    ///\ref named-templ-param "Named parameter" for setting
     
    10391039  };
    10401040
    1041   /// Default traits class used by \ref DijkstraWizard
     1041  /// Default traits class used by DijkstraWizard
    10421042
    10431043  /// To make it easier to use Dijkstra algorithm
  • lemon/dim2.h

    r253 r313  
    260260
    261261
    262   /// Bounding box of plain vectors (\ref Point points).
     262  /// Bounding box of plain vectors (points).
    263263
    264264  /// A class to calculate or store the bounding box of plain vectors
    265   /// (\ref Point points).
     265  /// (\ref Point "points").
    266266  template<typename T>
    267267  class Box {
     
    574574  }
    575575
    576   ///Map of x-coordinates of a \ref Point "Point"-map
    577 
    578   ///\ingroup maps
     576  ///Map of x-coordinates of a <tt>Point</tt>-map
     577
    579578  ///Map of x-coordinates of a \ref Point "Point"-map.
    580   ///
     579  ///\ingroup maps
    581580  template<class M>
    582581  class XMap
     
    593592  };
    594593
    595   ///Returns an \ref XMap class
    596 
    597   ///This function just returns an \ref XMap class.
     594  ///Returns an XMap class
     595
     596  ///This function just returns an XMap class.
    598597  ///
    599598  ///\ingroup maps
     
    611610  }
    612611
    613   ///Constant (read only) version of \ref XMap
    614 
    615   ///\ingroup maps
    616   ///Constant (read only) version of \ref XMap
    617   ///
     612  ///Constant (read only) version of XMap
     613
     614  ///Constant (read only) version of XMap.
     615  ///\ingroup maps
    618616  template<class M>
    619617  class ConstXMap
     
    629627  };
    630628
    631   ///Returns a \ref ConstXMap class
    632 
    633   ///This function just returns a \ref ConstXMap class.
     629  ///Returns a ConstXMap class
     630
     631  ///This function just returns a ConstXMap class.
    634632  ///
    635633  ///\ingroup maps
     
    641639  }
    642640
    643   ///Map of y-coordinates of a \ref Point "Point"-map
    644 
    645   ///\ingroup maps
     641  ///Map of y-coordinates of a <tt>Point</tt>-map
     642
    646643  ///Map of y-coordinates of a \ref Point "Point"-map.
    647   ///
     644  ///\ingroup maps
    648645  template<class M>
    649646  class YMap
     
    660657  };
    661658
    662   ///Returns a \ref YMap class
    663 
    664   ///This function just returns a \ref YMap class.
     659  ///Returns a YMap class
     660
     661  ///This function just returns a YMap class.
    665662  ///
    666663  ///\ingroup maps
     
    678675  }
    679676
    680   ///Constant (read only) version of \ref YMap
    681 
    682   ///\ingroup maps
    683   ///Constant (read only) version of \ref YMap
    684   ///
     677  ///Constant (read only) version of YMap
     678
     679  ///Constant (read only) version of YMap.
     680  ///\ingroup maps
    685681  template<class M>
    686682  class ConstYMap
     
    696692  };
    697693
    698   ///Returns a \ref ConstYMap class
    699 
    700   ///This function just returns a \ref ConstYMap class.
     694  ///Returns a ConstYMap class
     695
     696  ///This function just returns a ConstYMap class.
    701697  ///
    702698  ///\ingroup maps
     
    709705
    710706
    711   ///\brief Map of the \ref Point::normSquare() "normSquare()"
    712   ///of a \ref Point "Point"-map
     707  ///\brief Map of the normSquare() of a <tt>Point</tt>-map
    713708  ///
    714709  ///Map of the \ref Point::normSquare() "normSquare()"
     
    728723  };
    729724
    730   ///Returns a \ref NormSquareMap class
    731 
    732   ///This function just returns a \ref NormSquareMap class.
     725  ///Returns a NormSquareMap class
     726
     727  ///This function just returns a NormSquareMap class.
    733728  ///
    734729  ///\ingroup maps
  • lemon/graph_to_eps.h

    r291 r313  
    6363  }
    6464
    65 ///Default traits class of \ref GraphToEps
     65///Default traits class of GraphToEps
    6666
    6767///Default traits class of \ref GraphToEps.
  • lemon/list_graph.h

    r280 r313  
    414414    ///
    415415    ///\note The <tt>InArcIt</tt>s referencing the changed arc remain
    416     ///valid. However the <tt>ArcIt<tt>s and <tt>OutArcIt</tt>s are
     416    ///valid. However the <tt>ArcIt</tt>s and <tt>OutArcIt</tt>s are
    417417    ///invalidated.
    418418    ///
  • lemon/maps.h

    r301 r313  
    4444  class MapBase {
    4545  public:
    46     /// \biref The key type of the map.
     46    /// \brief The key type of the map.
    4747    typedef K Key;
    4848    /// \brief The value type of the map.
     
    22672267    ///
    22682268    /// Constructor
    2269     /// \param _digraph The digraph that the map belongs to.
     2269    /// \param digraph The digraph that the map belongs to.
    22702270    explicit SourceMap(const Digraph& digraph) : _digraph(digraph) {}
    22712271
     
    23062306    ///
    23072307    /// Constructor
    2308     /// \param _digraph The digraph that the map belongs to.
     2308    /// \param digraph The digraph that the map belongs to.
    23092309    explicit TargetMap(const Digraph& digraph) : _digraph(digraph) {}
    23102310
     
    23452345    ///
    23462346    /// Constructor
    2347     /// \param _graph The graph that the map belongs to.
     2347    /// \param graph The graph that the map belongs to.
    23482348    explicit ForwardMap(const Graph& graph) : _graph(graph) {}
    23492349
     
    23842384    ///
    23852385    /// Constructor
    2386     /// \param _graph The graph that the map belongs to.
     2386    /// \param graph The graph that the map belongs to.
    23872387    explicit BackwardMap(const Graph& graph) : _graph(graph) {}
    23882388
  • lemon/path.h

    r236 r313  
    850850    int empty() const { return len == 0; }
    851851
    852     /// \break Erase all arcs in the digraph.
     852    /// \brief Erase all arcs in the digraph.
    853853    void clear() {
    854854      len = 0;
  • lemon/smart_graph.h

    r280 r313  
    366366
    367367      ///This constructor immediately makes a snapshot of the digraph.
    368       ///\param _g The digraph we make a snapshot of.
     368      ///\param graph The digraph we make a snapshot of.
    369369      Snapshot(SmartDigraph &graph) : _graph(&graph) {
    370370        node_num=_graph->nodes.size();
     
    378378      ///This function can be called more than once. In case of a repeated
    379379      ///call, the previous snapshot gets lost.
    380       ///\param _g The digraph we make the snapshot of.
     380      ///\param graph The digraph we make the snapshot of.
    381381      void save(SmartDigraph &graph)
    382382      {
     
    776776
    777777      ///This constructor immediately makes a snapshot of the digraph.
    778       ///\param g The digraph we make a snapshot of.
     778      ///\param graph The digraph we make a snapshot of.
    779779      Snapshot(SmartGraph &graph) {
    780780        graph.saveSnapshot(*this);
     
    787787      ///This function can be called more than once. In case of a repeated
    788788      ///call, the previous snapshot gets lost.
    789       ///\param g The digraph we make the snapshot of.
     789      ///\param graph The digraph we make the snapshot of.
    790790      void save(SmartGraph &graph)
    791791      {
  • lemon/time_measure.h

    r280 r313  
    312312    ///Basically a Timer can be either running or stopped,
    313313    ///but it provides a bit finer control on the execution.
    314     ///The \ref Timer also counts the number of \ref start()
    315     ///executions, and is stops only after the same amount (or more)
    316     ///\ref stop() "stop()"s. This can be useful e.g. to compute
    317     ///the running time
     314    ///The \ref lemon::Timer "Timer" also counts the number of
     315    ///\ref lemon::Timer::start() "start()" executions, and it stops
     316    ///only after the same amount (or more) \ref lemon::Timer::stop()
     317    ///"stop()"s. This can be useful e.g. to compute the running time
    318318    ///of recursive functions.
    319     ///
    320319
    321320    ///@{
     
    473472  };
    474473
    475   ///Same as \ref Timer but prints a report on destruction.
     474  ///Same as Timer but prints a report on destruction.
    476475
    477476  ///Same as \ref Timer but prints a report on destruction.
     
    492491    std::ostream &_os;
    493492  public:
    494     ///\e
    495 
     493    ///Constructor
     494
     495    ///Constructor.
    496496    ///\param title This text will be printed before the ellapsed time.
    497497    ///\param os The stream to print the report to.
    498498    ///\param run Sets whether the timer should start immediately.
    499 
    500499    TimeReport(std::string title,std::ostream &os=std::cerr,bool run=true)
    501500      : Timer(run), _title(title), _os(os){}
    502     ///\e Prints the ellapsed time on destruction.
     501    ///Destructor that prints the ellapsed time
    503502    ~TimeReport()
    504503    {
     
    507506  };
    508507
    509   ///'Do nothing' version of \ref TimeReport
     508  ///'Do nothing' version of TimeReport
    510509
    511510  ///\sa TimeReport
Note: See TracChangeset for help on using the changeset viewer.