Doxygen cleanup.

(bzr r10660)

25 files changed, 35 insertions, 31 deletions

diff --git a/src/ui/widget/button.cpp b/src/ui/widget/button.cpp
index 19c69ba44..fe4aa90ce 100644
--- a/src/ui/widget/button.cpp
+++ b/src/ui/widget/button.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Button and CheckButton widgets
+ * Button and CheckButton widgets.
  *
  * Author:
  *   buliabyak@gmail.com
diff --git a/src/ui/widget/color-picker.cpp b/src/ui/widget/color-picker.cpp
index 650ed10f6..bd7a666d2 100644
--- a/src/ui/widget/color-picker.cpp
+++ b/src/ui/widget/color-picker.cpp
@@ -1,5 +1,6 @@
-/** \file
- * \brief  Color picker button & window
+/**
+ * @file
+ * Color picker button & window.
  *
  * Authors:
  *   Lauris Kaplinski <lauris@kaplinski.com>
diff --git a/src/ui/widget/dock-item.cpp b/src/ui/widget/dock-item.cpp
index 87f4d0840..9c6758bc0 100644
--- a/src/ui/widget/dock-item.cpp
+++ b/src/ui/widget/dock-item.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief A custom Inkscape wrapper around gdl_dock_item
+ * A custom Inkscape wrapper around gdl_dock_item.
  *
  * Author:
  *   Gustav Broberg <broberg@kth.se>
diff --git a/src/ui/widget/dock.cpp b/src/ui/widget/dock.cpp
index 02e1f2b41..627b01e27 100644
--- a/src/ui/widget/dock.cpp
+++ b/src/ui/widget/dock.cpp
@@ -1,5 +1,6 @@
-/** @file
- * @brief A desktop dock pane to dock dialogs.
+/**
+ * @file
+ * A desktop dock pane to dock dialogs.
  */
 /* Author:
  *   Gustav Broberg <broberg@kth.se>
diff --git a/src/ui/widget/entry.cpp b/src/ui/widget/entry.cpp
index 7b19ac861..ce7552fd6 100644
--- a/src/ui/widget/entry.cpp
+++ b/src/ui/widget/entry.cpp
@@ -1,6 +1,7 @@
-/** \file
+/**
+ * @file
  *
- * \brief Helperclass for Gtk::Entry widgets
+ * Helperclass for Gtk::Entry widgets.
  *
  * Authors:
  *   Johan Engelen <goejendaagh@zonnet.nl>
diff --git a/src/ui/widget/handlebox.cpp b/src/ui/widget/handlebox.cpp
index b82b715bb..f5b716975 100644
--- a/src/ui/widget/handlebox.cpp
+++ b/src/ui/widget/handlebox.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief HandleBox Widget - Adds a detachment handle to another widget.
+ * HandleBox Widget - Adds a detachment handle to another widget.
  *
  * This work really doesn't amount to much more than a convenience constructor
  * for Gtk::HandleBox.  Maybe this could be contributed back to Gtkmm, as
diff --git a/src/ui/widget/icon-widget.cpp b/src/ui/widget/icon-widget.cpp
index 64415f421..c3780b616 100644
--- a/src/ui/widget/icon-widget.cpp
+++ b/src/ui/widget/icon-widget.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Icon Widget
+ * Icon Widget.
  *
  * Author:
  *   Bryce Harrington <bryce@bryceharrington.org>
diff --git a/src/ui/widget/labelled.cpp b/src/ui/widget/labelled.cpp
index c55b57616..a62d1a470 100644
--- a/src/ui/widget/labelled.cpp
+++ b/src/ui/widget/labelled.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Labelled Widget - Adds a label with optional icon or suffix to
+ * Labelled Widget - Adds a label with optional icon or suffix to
  *        another widget.
  *
  * Authors:
diff --git a/src/ui/widget/notebook-page.cpp b/src/ui/widget/notebook-page.cpp
index 47035ce2f..eea8aefba 100644
--- a/src/ui/widget/notebook-page.cpp
+++ b/src/ui/widget/notebook-page.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Notebook page widget
+ * Notebook page widget.
  *
  * Author:
  *   Bryce Harrington <bryce@bryceharrington.org>
diff --git a/src/ui/widget/panel.cpp b/src/ui/widget/panel.cpp
index 3e0c27587..aaa8e2a70 100644
--- a/src/ui/widget/panel.cpp
+++ b/src/ui/widget/panel.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Panel widget
+ * Panel widget.
  *
  * Authors:
  *   Bryce Harrington <bryce@bryceharrington.org>
diff --git a/src/ui/widget/point.cpp b/src/ui/widget/point.cpp
index ca7f7a501..7a4b4459a 100644
--- a/src/ui/widget/point.cpp
+++ b/src/ui/widget/point.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Point Widget - A labelled text box, with spin buttons and optional
+ * Point Widget - A labelled text box, with spin buttons and optional
  *        icon or suffix, for entering arbitrary coordinate values.
  *
  * Authors:
diff --git a/src/ui/widget/preferences-widget.cpp b/src/ui/widget/preferences-widget.cpp
index 68faa3c66..b88123ab1 100644
--- a/src/ui/widget/preferences-widget.cpp
+++ b/src/ui/widget/preferences-widget.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Inkscape Preferences dialog
+ * Inkscape Preferences dialog.
  *
  * Authors:
  *   Marco Scholten
diff --git a/src/ui/widget/random.cpp b/src/ui/widget/random.cpp
index 3dcf09cb5..e2fb30812 100644
--- a/src/ui/widget/random.cpp
+++ b/src/ui/widget/random.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Scalar Widget - A labelled text box, with spin buttons and optional
+ * Scalar Widget - A labelled text box, with spin buttons and optional
  *        icon or suffix, for entering arbitrary number values. It adds an extra
  *       number called "startseed", that is not UI edittable, but should be put in SVG.
  *      This does NOT generate a random number, but provides merely the saving of 
diff --git a/src/ui/widget/rendering-options.cpp b/src/ui/widget/rendering-options.cpp
index 48e257af7..1ceaa784e 100644
--- a/src/ui/widget/rendering-options.cpp
+++ b/src/ui/widget/rendering-options.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Rendering options widget
+ * Rendering options widget.
  *
  * Author:
  *   Kees Cook <kees@outflux.net>
diff --git a/src/ui/widget/rotateable.cpp b/src/ui/widget/rotateable.cpp
index 23d5363ef..6a65d6ab3 100644
--- a/src/ui/widget/rotateable.cpp
+++ b/src/ui/widget/rotateable.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief widget adjustable by dragging it to rotate away from a zero-change axis
+ * widget adjustable by dragging it to rotate away from a zero-change axis.
  *
  * Authors:
  *   buliabyak@gmail.com
diff --git a/src/ui/widget/scalar-unit.cpp b/src/ui/widget/scalar-unit.cpp
index 1c0fdff68..47e9b23b2 100644
--- a/src/ui/widget/scalar-unit.cpp
+++ b/src/ui/widget/scalar-unit.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Scalar Unit Widget - A labelled text box, with spin buttons and
+ * Scalar Unit Widget - A labelled text box, with spin buttons and
  *        optional icon or suffix, for entering the values of various unit
  *        types.
  *
diff --git a/src/ui/widget/scalar.cpp b/src/ui/widget/scalar.cpp
index 6ada379fb..4237d9db9 100644
--- a/src/ui/widget/scalar.cpp
+++ b/src/ui/widget/scalar.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Scalar Widget - A labelled text box, with spin buttons and optional
+ * Scalar Widget - A labelled text box, with spin buttons and optional
  *        icon or suffix, for entering arbitrary number values.
  *
  * Authors:
diff --git a/src/ui/widget/selected-style.cpp b/src/ui/widget/selected-style.cpp
index 0aa65b1a9..516da5761 100644
--- a/src/ui/widget/selected-style.cpp
+++ b/src/ui/widget/selected-style.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Selected style indicator (fill, stroke, opacity)
+ * Selected style indicator (fill, stroke, opacity).
  *
  * Author:
  *   buliabyak@gmail.com
diff --git a/src/ui/widget/spin-slider.cpp b/src/ui/widget/spin-slider.cpp
index 259b057aa..4a3b0dd77 100644
--- a/src/ui/widget/spin-slider.cpp
+++ b/src/ui/widget/spin-slider.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Groups an HScale and a SpinButton together using the same Adjustment
+ * Groups an HScale and a SpinButton together using the same Adjustment.
  *
  * Author:
  *   Nicholas Bishop <nicholasbishop@gmail.com>
diff --git a/src/ui/widget/spinbutton.cpp b/src/ui/widget/spinbutton.cpp
index 32090f96c..78b00bebc 100644
--- a/src/ui/widget/spinbutton.cpp
+++ b/src/ui/widget/spinbutton.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief SpinButton widget, that allows entry of both '.' and ',' for the decimal, even when in numeric mode.
+ * SpinButton widget, that allows entry of both '.' and ',' for the decimal, even when in numeric mode.
  */
 /*
  * Author:
diff --git a/src/ui/widget/style-subject.cpp b/src/ui/widget/style-subject.cpp
index f3a8478ea..4a1b83175 100644
--- a/src/ui/widget/style-subject.cpp
+++ b/src/ui/widget/style-subject.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Abstraction for different style widget operands
+ * Abstraction for different style widget operands.
  *
  * Copyright (C) 2007 MenTaLguY <mental@rydia.net>
  *   Abhishek Sharma
diff --git a/src/ui/widget/style-swatch.cpp b/src/ui/widget/style-swatch.cpp
index 47f6292e3..41366f749 100644
--- a/src/ui/widget/style-swatch.cpp
+++ b/src/ui/widget/style-swatch.cpp
@@ -1,5 +1,6 @@
-/** @file
- * @brief Static style swatch (fill, stroke, opacity)
+/**
+ * @file
+ * Static style swatch (fill, stroke, opacity).
  */
 /* Authors:
  *   buliabyak@gmail.com
@@ -43,7 +44,7 @@ namespace UI {
 namespace Widget {
 
 /**
- * @brief Watches whether the tool uses the current style
+ * Watches whether the tool uses the current style.
  */
 class StyleSwatch::ToolObserver : public Inkscape::Preferences::Observer {
 public:
@@ -57,7 +58,7 @@ private:
 };
 
 /**
- * @brief Watches for changes in the observed style pref
+ * Watches for changes in the observed style pref.
  */
 class StyleSwatch::StyleObserver : public Inkscape::Preferences::Observer {
 public:
diff --git a/src/ui/widget/text.cpp b/src/ui/widget/text.cpp
index 581491f0e..a5540e428 100644
--- a/src/ui/widget/text.cpp
+++ b/src/ui/widget/text.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Text Widget - A labelled text box, with spin buttons and optional
+ * Text Widget - A labelled text box, with spin buttons and optional
  *        icon or suffix, for entering arbitrary number values.
  *
  * Authors:
diff --git a/src/ui/widget/toolbox.cpp b/src/ui/widget/toolbox.cpp
index 5e5f43263..41a13f4e9 100644
--- a/src/ui/widget/toolbox.cpp
+++ b/src/ui/widget/toolbox.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Toolbox Widget - A detachable toolbar for buttons and other widgets.
+ * Toolbox Widget - A detachable toolbar for buttons and other widgets.
  *
  * Author:
  *   Derek P. Moore <derekm@hackunix.org>
diff --git a/src/ui/widget/unit-menu.cpp b/src/ui/widget/unit-menu.cpp
index 362f5d90f..bb0b65576 100644
--- a/src/ui/widget/unit-menu.cpp
+++ b/src/ui/widget/unit-menu.cpp
@@ -1,5 +1,5 @@
 /**
- * \brief Unit Menu Widget - A drop down menu for choosing unit types.
+ * Unit Menu Widget - A drop down menu for choosing unit types.
  *
  * Author:
  *   Bryce Harrington <bryce@bryceharrington.org>