gravatar
kpeter (Peter Kovacs)
kpeter@inf.elte.hu
Doc improvements is some files.
0 5 0
default
5 files changed with 69 insertions and 75 deletions:
↑ Collapse diff ↑
Ignore white space 6 line context
... ...
@@ -18,5 +18,5 @@
18 18

	
19 19
///\file
20
///\brief Some basic non inline function and static global data.
20
///\brief Some basic non-inline functions and static global data.
21 21

	
22 22
#include<lemon/tolerance.h>
Ignore white space 4 line context
... ...
@@ -27,4 +27,5 @@
27 27
  /// \brief Dummy type to make it easier to create invalid iterators.
28 28
  ///
29
  /// Dummy type to make it easier to create invalid iterators.
29 30
  /// See \ref INVALID for the usage.
30 31
  struct Invalid {
Ignore white space 6 line context
... ...
@@ -28,6 +28,5 @@
28 28
///
29 29
/// The class \ref lemon::dim2::Point "dim2::Point" implements
30
///a two dimensional vector with the usual
31
/// operations.
30
/// a two dimensional vector with the usual operations.
32 31
///
33 32
/// The class \ref lemon::dim2::BoundingBox "dim2::BoundingBox"
... ...
@@ -50,7 +49,5 @@
50 49

	
51 50
  /// A simple two dimensional vector (plainvector) implementation
52
  ///with the usual vector
53
  /// operators.
54
  ///
51
  /// with the usual vector operations.
55 52
  template<typename T>
56 53
    class Point {
... ...
@@ -71,5 +68,5 @@
71 68
      Point(T a, T b) : x(a), y(b) { }
72 69

	
73
      ///The dimension of the vector.
70
      ///Returns the dimension of the vector (i.e. returns 2).
74 71

	
75 72
      ///The dimension of the vector.
... ...
@@ -97,5 +94,5 @@
97 94
      }
98 95
  
99
      ///Increment the left hand side by u
96
      ///Increment the left hand side by \c u
100 97
      Point<T>& operator +=(const Point<T>& u) {
101 98
        x += u.x;
... ...
@@ -104,5 +101,5 @@
104 101
      }
105 102
  
106
      ///Decrement the left hand side by u
103
      ///Decrement the left hand side by \c u
107 104
      Point<T>& operator -=(const Point<T>& u) {
108 105
        x -= u.x;
... ...
@@ -316,4 +313,5 @@
316 313
      ///if at least one point was added to the box or the coordinates of
317 314
      ///the box were set).
315
      ///
318 316
      ///The coordinates of an empty bounding box are not defined. 
319 317
      bool empty() const {
... ...
@@ -326,7 +324,7 @@
326 324
      }
327 325

	
328
      ///Give back the bottom left corner
326
      ///Give back the bottom left corner of the box
329 327

	
330
      ///Give back the bottom left corner.
328
      ///Give back the bottom left corner of the box.
331 329
      ///If the bounding box is empty, then the return value is not defined.
332 330
      Point<T> bottomLeft() const {
... ...
@@ -334,7 +332,7 @@
334 332
      }
335 333

	
336
      ///Set the bottom left corner
334
      ///Set the bottom left corner of the box
337 335

	
338
      ///Set the bottom left corner.
336
      ///Set the bottom left corner of the box.
339 337
      ///It should only be used for non-empty box.
340 338
      void bottomLeft(Point<T> p) {
... ...
@@ -342,7 +340,7 @@
342 340
      }
343 341

	
344
      ///Give back the top right corner
342
      ///Give back the top right corner of the box
345 343

	
346
      ///Give back the top right corner.
344
      ///Give back the top right corner of the box.
347 345
      ///If the bounding box is empty, then the return value is not defined.
348 346
      Point<T> topRight() const {
... ...
@@ -350,7 +348,7 @@
350 348
      }
351 349

	
352
      ///Set the top right corner
350
      ///Set the top right corner of the box
353 351

	
354
      ///Set the top right corner.
352
      ///Set the top right corner of the box.
355 353
      ///It should only be used for non-empty box.
356 354
      void topRight(Point<T> p) {
... ...
@@ -358,7 +356,7 @@
358 356
      }
359 357

	
360
      ///Give back the bottom right corner
358
      ///Give back the bottom right corner of the box
361 359

	
362
      ///Give back the bottom right corner.
360
      ///Give back the bottom right corner of the box.
363 361
      ///If the bounding box is empty, then the return value is not defined.
364 362
      Point<T> bottomRight() const {
... ...
@@ -366,7 +364,7 @@
366 364
      }
367 365

	
368
      ///Set the bottom right corner
366
      ///Set the bottom right corner of the box
369 367

	
370
      ///Set the bottom right corner.
368
      ///Set the bottom right corner of the box.
371 369
      ///It should only be used for non-empty box.
372 370
      void bottomRight(Point<T> p) {
... ...
@@ -375,7 +373,7 @@
375 373
      }
376 374
 
377
      ///Give back the top left corner
375
      ///Give back the top left corner of the box
378 376

	
379
      ///Give back the top left corner.
377
      ///Give back the top left corner of the box.
380 378
      ///If the bounding box is empty, then the return value is not defined.
381 379
      Point<T> topLeft() const {
... ...
@@ -383,7 +381,7 @@
383 381
      }
384 382

	
385
      ///Set the top left corner
383
      ///Set the top left corner of the box
386 384

	
387
      ///Set the top left corner.
385
      ///Set the top left corner of the box.
388 386
      ///It should only be used for non-empty box.
389 387
      void topLeft(Point<T> p) {
... ...
@@ -534,8 +532,8 @@
534 532

	
535 533

	
536
  ///Map of x-coordinates of a Point map
534
  ///Map of x-coordinates of a \ref Point "Point"-map
537 535

	
538 536
  ///\ingroup maps
539
  ///Map of x-coordinates of a \ref dim2::Point "Point"-map.
537
  ///Map of x-coordinates of a \ref Point "Point"-map.
540 538
  ///
541 539
  template<class M>
... ...
@@ -571,5 +569,5 @@
571 569
  }
572 570

	
573
  ///Constant (read only) version of XMap
571
  ///Constant (read only) version of \ref XMap
574 572

	
575 573
  ///\ingroup maps
... ...
@@ -601,5 +599,5 @@
601 599
  }
602 600

	
603
  ///Map of y-coordinates of a Point map
601
  ///Map of y-coordinates of a \ref Point "Point"-map
604 602
    
605 603
  ///\ingroup maps
... ...
@@ -638,5 +636,5 @@
638 636
  }
639 637

	
640
  ///Constant (read only) version of YMap
638
  ///Constant (read only) version of \ref YMap
641 639

	
642 640
  ///\ingroup maps
... ...
@@ -669,11 +667,10 @@
669 667

	
670 668

	
671
    ///\brief Map of the normSquare()
672
    ///of a Point map
673
    ///
674
    ///Map of the \ref Point::normSquare() "normSquare()"
675
    ///of a \ref Point "Point"-map.
676
    ///\ingroup maps
677
    ///
669
  ///\brief Map of the \ref Point::normSquare() "normSquare()"
670
  ///of a \ref Point "Point"-map
671
  ///
672
  ///Map of the \ref Point::normSquare() "normSquare()"
673
  ///of a \ref Point "Point"-map.
674
  ///\ingroup maps
678 675
  template<class M>
679 676
  class NormSquareMap 
Ignore white space 6 line context
... ...
@@ -511,5 +511,5 @@
511 511
  ///\endcode
512 512
  ///
513
  /// The lemon provides a global instance of the random number
513
  /// LEMON provides a global instance of the random number
514 514
  /// generator which name is \ref lemon::rnd "rnd". Usually it is a
515 515
  /// good programming convenience to use this global generator to get
... ...
@@ -527,10 +527,10 @@
527 527
  public:
528 528

	
529
    /// \brief Constructor
529
    /// \brief Default constructor
530 530
    ///
531 531
    /// Constructor with constant seeding.
532 532
    Random() { core.initState(); }
533 533

	
534
    /// \brief Constructor
534
    /// \brief Constructor with seed
535 535
    ///
536 536
    /// Constructor with seed. The current number type will be converted
... ...
@@ -541,5 +541,5 @@
541 541
    }
542 542

	
543
    /// \brief Constructor
543
    /// \brief Constructor with array seeding
544 544
    ///
545 545
    /// Constructor with array seeding. The given range should contain
... ...
@@ -578,5 +578,5 @@
578 578
    ///
579 579
    /// It returns a random real number from the range [0, 1). The
580
    /// default Number type is double.
580
    /// default Number type is \c double.
581 581
    template <typename Number>
582 582
    Number real() {
... ...
@@ -654,6 +654,6 @@
654 654
    ///
655 655
    /// It returns a random non-negative integer uniformly from the
656
    /// whole range of the current \c Number type.  The default result
657
    /// type of this function is unsigned int.
656
    /// whole range of the current \c Number type. The default result
657
    /// type of this function is <tt>unsigned int</tt>.
658 658
    template <typename Number>
659 659
    Number uinteger() {
... ...
@@ -669,5 +669,5 @@
669 669
    /// It returns a random integer uniformly from the whole range of
670 670
    /// the current \c Number type. The default result type of this
671
    /// function is int.
671
    /// function is \c int.
672 672
    template <typename Number>
673 673
    Number integer() {
... ...
@@ -690,5 +690,5 @@
690 690
    }
691 691

	
692
    ///\name Nonuniform distributions
692
    ///\name Non-uniform distributions
693 693
    ///
694 694
    
Ignore white space 6 line context
... ...
@@ -37,10 +37,10 @@
37 37
  ///as a result of a probably inexact computation.
38 38
  ///
39
  ///Tolerance is a class to provide a basic way to
39
  ///\ref Tolerance is a class to provide a basic way to
40 40
  ///handle the comparison of numbers that are obtained
41 41
  ///as a result of a probably inexact computation.
42 42
  ///
43 43
  ///This is an abstract class, it should be specialized for all numerical
44
  ///data types. These specialized classes like Tolerance<double>
44
  ///data types. These specialized classes like \ref Tolerance<double>
45 45
  ///may offer additional tuning parameters.
46 46
  ///
... ...
@@ -49,11 +49,7 @@
49 49
  ///\sa Tolerance<long double>
50 50
  ///\sa Tolerance<int>
51
#if defined __GNUC__ && !defined __STRICT_ANSI__  
52 51
  ///\sa Tolerance<long long int>
53
#endif
54 52
  ///\sa Tolerance<unsigned int>
55
#if defined __GNUC__ && !defined __STRICT_ANSI__  
56 53
  ///\sa Tolerance<unsigned long long int>
57
#endif
58 54

	
59 55
  template<class T>
... ...
@@ -64,5 +60,5 @@
64 60

	
65 61
    ///\name Comparisons
66
    ///The concept is that these bool functions return with \c true only if
62
    ///The concept is that these bool functions return \c true only if
67 63
    ///the related comparisons hold even if some numerical error appeared
68 64
    ///during the computations.
... ...
@@ -108,19 +104,19 @@
108 104
    ///Constructor setting the epsilon tolerance to the default value.
109 105
    Tolerance() : _epsilon(def_epsilon) {}
110
    ///Constructor setting the epsilon tolerance.
106
    ///Constructor setting the epsilon tolerance to the given value.
111 107
    Tolerance(float e) : _epsilon(e) {}
112 108

	
113
    ///Return the epsilon value.
109
    ///Returns the epsilon value.
114 110
    Value epsilon() const {return _epsilon;}
115
    ///Set the epsilon value.
111
    ///Sets the epsilon value.
116 112
    void epsilon(Value e) {_epsilon=e;}
117 113

	
118
    ///Return the default epsilon value.
114
    ///Returns the default epsilon value.
119 115
    static Value defaultEpsilon() {return def_epsilon;}
120
    ///Set the default epsilon value.
116
    ///Sets the default epsilon value.
121 117
    static void defaultEpsilon(Value e) {def_epsilon=e;}
122 118

	
123 119
    ///\name Comparisons
124
    ///See class Tolerance for more details.
120
    ///See \ref Tolerance for more details.
125 121

	
126 122
    ///@{
... ...
@@ -159,19 +155,19 @@
159 155
    ///Constructor setting the epsilon tolerance to the default value.
160 156
    Tolerance() : _epsilon(def_epsilon) {}
161
    ///Constructor setting the epsilon tolerance.
157
    ///Constructor setting the epsilon tolerance to the given value.
162 158
    Tolerance(double e) : _epsilon(e) {}
163 159

	
164
    ///Return the epsilon value.
160
    ///Returns the epsilon value.
165 161
    Value epsilon() const {return _epsilon;}
166
    ///Set the epsilon value.
162
    ///Sets the epsilon value.
167 163
    void epsilon(Value e) {_epsilon=e;}
168 164

	
169
    ///Return the default epsilon value.
165
    ///Returns the default epsilon value.
170 166
    static Value defaultEpsilon() {return def_epsilon;}
171
    ///Set the default epsilon value.
167
    ///Sets the default epsilon value.
172 168
    static void defaultEpsilon(Value e) {def_epsilon=e;}
173 169

	
174 170
    ///\name Comparisons
175
    ///See class Tolerance for more details.
171
    ///See \ref Tolerance for more details.
176 172

	
177 173
    ///@{
... ...
@@ -210,19 +206,19 @@
210 206
    ///Constructor setting the epsilon tolerance to the default value.
211 207
    Tolerance() : _epsilon(def_epsilon) {}
212
    ///Constructor setting the epsilon tolerance.
208
    ///Constructor setting the epsilon tolerance to the given value.
213 209
    Tolerance(long double e) : _epsilon(e) {}
214 210

	
215
    ///Return the epsilon value.
211
    ///Returns the epsilon value.
216 212
    Value epsilon() const {return _epsilon;}
217
    ///Set the epsilon value.
213
    ///Sets the epsilon value.
218 214
    void epsilon(Value e) {_epsilon=e;}
219 215

	
220
    ///Return the default epsilon value.
216
    ///Returns the default epsilon value.
221 217
    static Value defaultEpsilon() {return def_epsilon;}
222
    ///Set the default epsilon value.
218
    ///Sets the default epsilon value.
223 219
    static void defaultEpsilon(Value e) {def_epsilon=e;}
224 220

	
225 221
    ///\name Comparisons
226
    ///See class Tolerance for more details.
222
    ///See \ref Tolerance for more details.
227 223

	
228 224
    ///@{
... ...
@@ -257,5 +253,5 @@
257 253

	
258 254
    ///\name Comparisons
259
    ///See Tolerance for more details.
255
    ///See \ref Tolerance for more details.
260 256

	
261 257
    ///@{
... ...
@@ -290,5 +286,5 @@
290 286

	
291 287
    ///\name Comparisons
292
    ///See Tolerance for more details.
288
    ///See \ref Tolerance for more details.
293 289

	
294 290
    ///@{
... ...
@@ -324,5 +320,5 @@
324 320

	
325 321
    ///\name Comparisons
326
    ///See Tolerance for more details.
322
    ///See \ref Tolerance for more details.
327 323

	
328 324
    ///@{
... ...
@@ -357,5 +353,5 @@
357 353

	
358 354
    ///\name Comparisons
359
    ///See Tolerance for more details.
355
    ///See \ref Tolerance for more details.
360 356

	
361 357
    ///@{
0 comments (0 inline)