Re: Doxygen \todos

diff -r e77b384a9d4d dw/fltkimgbuf.cc
--- a/dw/fltkimgbuf.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/fltkimgbuf.cc	Sun May 27 16:17:13 2012 +0400
@@ -51,7 +51,7 @@
    this->width = width;
    this->height = height;
 
-   // TODO: Maybe this is only for root buffers
+   /// \todo Maybe this is only for root buffers
    switch (type) {
       case RGBA: bpp = 4; break;
       case RGB:  bpp = 3; break;
@@ -204,7 +204,7 @@
 
 void FltkImgbuf::getRowArea (int row, dw::core::Rectangle *area)
 {
-   // TODO: May have to be adjusted.
+   /// \todo May have to be adjusted.
 
    if (isRoot()) {
       /* root buffer */
@@ -294,7 +294,7 @@
 
 int FltkImgbuf::scaledY(int ySrc)
 {
-   // TODO: May have to be adjusted.
+   /// \todo May have to be adjusted.
    assert (root != NULL);
    return ySrc * height / root->height;
 }
@@ -302,8 +302,8 @@
 void FltkImgbuf::draw (Fl_Widget *target, int xRoot, int yRoot,
                        int x, int y, int width, int height)
 {
-   // TODO: Clarify the question, whether "target" is the current widget
-   //       (and so has not to be passed at all).
+   /// \todo Clarify the question, whether "target" is the current widget
+   ///       (and so has not to be passed at all).
 
    _MSG("::draw: xRoot=%d x=%d yRoot=%d y=%d width=%d height=%d\n"
         "        this->width=%d this->height=%d\n",
diff -r e77b384a9d4d dw/fltkui.cc
--- a/dw/fltkui.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/fltkui.cc	Sun May 27 16:17:13 2012 +0400
@@ -325,10 +325,9 @@
    }
 }
 
-/*
- * Get FLTK state and translate to dw
- *
- * TODO: find a good home for this and the fltkviewbase.cc original.
+/**
+ * \brief Get FLTK state and translate to dw
+ * \todo find a good home for this and the fltkviewbase.cc original.
  */
 static core::ButtonState getDwButtonState ()
 {
@@ -1207,7 +1206,7 @@
 {
    bool selected = false;
 
-   /* TODO: make it impossible to select a group */
+   /// \todo make it impossible to select a group
    currParent = (Fl_Tree_Item *) newItem(name, enabled, selected);
    queueResize (true);
 }
diff -r e77b384a9d4d dw/image.cc
--- a/dw/image.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/image.cc	Sun May 27 16:17:13 2012 +0400
@@ -245,7 +245,7 @@
 
 void Image::enterNotifyImpl (core::EventCrossing *event)
 {
-   // BUG: this is wrong for image maps, but the cursor position is unknown.
+   /// \bug this is wrong for image maps, but the cursor position is unknown.
    currLink = getStyle()->x_link;
 
    if (currLink != -1) {
@@ -407,7 +407,7 @@
       }
    }
 
-   /** TODO: draw selection */
+   /** \todo draw selection */
 }
 
 core::Iterator *Image::iterator (core::Content::Type mask, bool atEnd)
diff -r e77b384a9d4d dw/layout.cc
--- a/dw/layout.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/layout.cc	Sun May 27 16:17:13 2012 +0400
@@ -1007,8 +1007,8 @@
    if (usesViewport && width > viewportWidth)
       canvasHeightGreater = false;
 
-   /* if size changes, redraw this view.
-    * TODO: this is a resize call (redraw/resize code needs a review). */
+   /* if size changes, redraw this view. */
+   /// \todo this is a resize call (redraw/resize code needs a review).
    if (viewportWidth != width || viewportHeight != height)
       queueResize();
 
diff -r e77b384a9d4d dw/textblock.cc
--- a/dw/textblock.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/textblock.cc	Sun May 27 16:17:13 2012 +0400
@@ -64,8 +64,8 @@
     * should not decrease the speed considerably.
     * (Current setting is for minimal memory usage. An interesting fact
     * is that high values decrease speed due to memory handling overhead!)
-    * TODO: Some tests would be useful.
     */
+   /// \todo Some tests would be useful.
    lines = new misc::SimpleVector <Line> (1);
    words = new misc::SimpleVector <Word> (1);
    anchors = new misc::SimpleVector <Anchor> (1);
@@ -1737,7 +1737,8 @@
       size->ascent = lout::misc::roundInt(size->ascent * factor);
       size->descent = lout::misc::roundInt(size->descent * factor);
 
-      /* TODO: The containing block's line-height property gives a minimum
+      /**
+       * \todo The containing block's line-height property gives a minimum
        * height for the line boxes. (Even when it's set to 'normal', i.e.,
        * AUTO? Apparently.) Once all block elements make Textblocks or
        * something, this can be handled.
diff -r e77b384a9d4d dw/textblock.hh
--- a/dw/textblock.hh	Sat May 26 13:58:42 2012 +0200
+++ b/dw/textblock.hh	Sun May 27 16:17:13 2012 +0400
@@ -157,7 +157,7 @@
 
    struct Word
    {
-      /* TODO: perhaps add a xLeft? */
+      /** \todo perhaps add a xLeft? */
       core::Requisition size;
       /* Space after the word, only if it's not a break: */
       short origSpace; /* from font, set by addSpace */
diff -r e77b384a9d4d dw/types.cc
--- a/dw/types.cc	Sat May 26 13:58:42 2012 +0200
+++ b/dw/types.cc	Sun May 27 16:17:13 2012 +0400
@@ -173,7 +173,7 @@
 bool Polygon::linesCross0(int ax1, int ay1, int ax2, int ay2,
                           int bx1, int by1, int bx2, int by2)
 {
-   /** TODO Some more description */
+   /** \todo Some more description */
    // If the scalar product is 0, it means that one point is on the second
    // line, so we check for <= 0, not < 0.
    int z1 = zOfVectorProduct (ax1 - bx1, ay1 - by1, bx2 - bx1, by2 - by1);