Removed a lot of useless "documentation"

I have to admit I contributed a large part of these. Sorry for that.
Less empty space, more attention to the code.

Acked-by: Jared Adams

22 files changed, 10 insertions, 99 deletions

diff --git a/src/gui/widgets/browserbox.h b/src/gui/widgets/browserbox.h
index 54a2a8cc..28ec734a 100644
--- a/src/gui/widgets/browserbox.h
+++ b/src/gui/widgets/browserbox.h
@@ -72,14 +72,8 @@ class BrowserBox : public gcn::Widget,
                    public gcn::MouseListener
 {
     public:
-        /**
-         * Constructor.
-         */
         BrowserBox(unsigned int mode = AUTO_SIZE, bool opaque = true);
 
-        /**
-         * Destructor.
-         */
         ~BrowserBox();
 
         /**
diff --git a/src/gui/widgets/button.h b/src/gui/widgets/button.h
index aa37261e..b750d9bb 100644
--- a/src/gui/widgets/button.h
+++ b/src/gui/widgets/button.h
@@ -46,9 +46,6 @@ class Button : public gcn::Button
         Button(const std::string &caption, const std::string &actionEventId,
                 gcn::ActionListener *listener);
 
-        /**
-         * Destructor.
-         */
         ~Button();
 
         /**
diff --git a/src/gui/widgets/channeltab.h b/src/gui/widgets/channeltab.h
index 842b80f7..0272655b 100644
--- a/src/gui/widgets/channeltab.h
+++ b/src/gui/widgets/channeltab.h
@@ -43,14 +43,8 @@ class ChannelTab : public ChatTab
     protected:
         friend class Channel;
 
-        /**
-         * Constructor.
-         */
         ChannelTab(Channel *channel);
 
-        /**
-         * Destructor.
-         */
         ~ChannelTab();
 
         void handleInput(const std::string &msg);
diff --git a/src/gui/widgets/chattab.h b/src/gui/widgets/chattab.h
index 1e187f23..6d262e11 100644
--- a/src/gui/widgets/chattab.h
+++ b/src/gui/widgets/chattab.h
@@ -37,9 +37,6 @@ class ScrollArea;
 class ChatTab : public Tab, public AutoCompleteLister
 {
     public:
-        /**
-         * Constructor.
-         */
         ChatTab(const std::string &name);
         ~ChatTab();
 
diff --git a/src/gui/widgets/checkbox.h b/src/gui/widgets/checkbox.h
index a7daa52d..27962f72 100644
--- a/src/gui/widgets/checkbox.h
+++ b/src/gui/widgets/checkbox.h
@@ -34,14 +34,8 @@ class Image;
 class CheckBox : public gcn::CheckBox
 {
     public:
-        /**
-         * Constructor.
-         */
         CheckBox(const std::string &caption, bool selected = false);
 
-        /**
-         * Destructor.
-         */
         ~CheckBox();
 
         /**
diff --git a/src/gui/widgets/emoteshortcutcontainer.h b/src/gui/widgets/emoteshortcutcontainer.h
index c3fb9d14..0021d838 100644
--- a/src/gui/widgets/emoteshortcutcontainer.h
+++ b/src/gui/widgets/emoteshortcutcontainer.h
@@ -35,14 +35,8 @@ class ImageSprite;
 class EmoteShortcutContainer : public ShortcutContainer
 {
     public:
-        /**
-         * Constructor. Initializes the graphic.
-         */
         EmoteShortcutContainer();
 
-        /**
-         * Destructor.
-         */
         virtual ~EmoteShortcutContainer();
 
         /**
diff --git a/src/gui/widgets/flowcontainer.h b/src/gui/widgets/flowcontainer.h
index a0e8dbf5..ee9f634b 100644
--- a/src/gui/widgets/flowcontainer.h
+++ b/src/gui/widgets/flowcontainer.h
@@ -34,17 +34,9 @@ class FlowContainer : public Container,
                       public gcn::WidgetListener
 {
     public:
-        /**
-         * Constructor. Initializes the shortcut container.
-         */
         FlowContainer(int boxWidth, int boxHeight);
 
         /**
-         * Destructor.
-         */
-        ~FlowContainer() {}
-
-        /**
          * Invoked when a widget changes its size. This is used to determine
          * the new height of the container.
          */
diff --git a/src/gui/widgets/icon.h b/src/gui/widgets/icon.h
index 27ed0db8..7b297756 100644
--- a/src/gui/widgets/icon.h
+++ b/src/gui/widgets/icon.h
@@ -36,6 +36,8 @@ class Icon : public gcn::Widget
     public:
         /**
          * Constructor.
+         *
+         * @param filename The file name of the image to display
          */
         Icon(const std::string &filename);
 
@@ -44,7 +46,7 @@ class Icon : public gcn::Widget
          */
         Icon(Image *image);
 
-        /** 
+        /**
          * Gets the current Image.
          */
         Image *getImage() const { return mImage; }
diff --git a/src/gui/widgets/itemcontainer.h b/src/gui/widgets/itemcontainer.h
index 89012a37..ca21ad3f 100644
--- a/src/gui/widgets/itemcontainer.h
+++ b/src/gui/widgets/itemcontainer.h
@@ -60,9 +60,6 @@ class ItemContainer : public gcn::Widget,
          */
         ItemContainer(Inventory *inventory, bool forceQuantity = false);
 
-        /**
-         * Destructor.
-         */
         virtual ~ItemContainer();
 
         /**
diff --git a/src/gui/widgets/itemshortcutcontainer.h b/src/gui/widgets/itemshortcutcontainer.h
index 9ec3f4c1..80f29c7b 100644
--- a/src/gui/widgets/itemshortcutcontainer.h
+++ b/src/gui/widgets/itemshortcutcontainer.h
@@ -38,14 +38,8 @@ class ItemPopup;
 class ItemShortcutContainer : public ShortcutContainer
 {
     public:
-        /**
-         * Constructor. Initializes the graphic.
-         */
         ItemShortcutContainer();
 
-        /**
-         * Destructor.
-         */
         virtual ~ItemShortcutContainer();
 
         /**
diff --git a/src/gui/widgets/label.h b/src/gui/widgets/label.h
index 2dfa254c..6b9cd2a8 100644
--- a/src/gui/widgets/label.h
+++ b/src/gui/widgets/label.h
@@ -1,6 +1,6 @@
 /*
  *  The Mana Client
- *  Copyright (c) 2009  Aethyra Development Team 
+ *  Copyright (c) 2009  Aethyra Development Team
  *
  *  This file is part of The Mana Client.
  *
@@ -32,9 +32,6 @@
 class Label : public gcn::Label
 {
     public:
-        /**
-         * Constructor.
-         */
         Label();
 
         /**
diff --git a/src/gui/widgets/layouthelper.h b/src/gui/widgets/layouthelper.h
index cf966029..0aeabb0d 100644
--- a/src/gui/widgets/layouthelper.h
+++ b/src/gui/widgets/layouthelper.h
@@ -34,14 +34,8 @@
 class LayoutHelper : public gcn::WidgetListener
 {
     public:
-        /**
-         * Constructor.
-         */
         LayoutHelper(gcn::Container *container);
 
-        /**
-         * Destructor.
-         */
         ~LayoutHelper();
 
         /**
diff --git a/src/gui/widgets/listbox.h b/src/gui/widgets/listbox.h
index 8b8c8b54..92505c15 100644
--- a/src/gui/widgets/listbox.h
+++ b/src/gui/widgets/listbox.h
@@ -36,9 +36,6 @@ class SelectionListener;
 class ListBox : public gcn::ListBox
 {
     public:
-        /**
-         * Constructor.
-         */
         ListBox(gcn::ListModel *listModel);
 
         ~ListBox();
diff --git a/src/gui/widgets/passwordfield.h b/src/gui/widgets/passwordfield.h
index 619cd842..0058233c 100644
--- a/src/gui/widgets/passwordfield.h
+++ b/src/gui/widgets/passwordfield.h
@@ -35,7 +35,7 @@ class PasswordField : public TextField
         /**
          * Constructor, initializes the password field with the given string.
          */
-        PasswordField(const std::string &text = "");
+        PasswordField(const std::string &text = std::string());
 
         /**
          * Draws the password field.
diff --git a/src/gui/widgets/playerbox.h b/src/gui/widgets/playerbox.h
index 4ce6782d..f6e70ef7 100644
--- a/src/gui/widgets/playerbox.h
+++ b/src/gui/widgets/playerbox.h
@@ -41,9 +41,6 @@ class PlayerBox : public gcn::ScrollArea
          */
         PlayerBox(const Being *being = 0);
 
-        /**
-         * Destructor.
-         */
         ~PlayerBox();
 
         /**
diff --git a/src/gui/widgets/radiobutton.h b/src/gui/widgets/radiobutton.h
index 7f839ea5..f8aa40f1 100644
--- a/src/gui/widgets/radiobutton.h
+++ b/src/gui/widgets/radiobutton.h
@@ -32,15 +32,9 @@ class Image;
 class RadioButton : public gcn::RadioButton
 {
     public:
-        /**
-         * Constructor.
-         */
         RadioButton(const std::string &caption,const std::string &group,
                 bool marked = false);
 
-        /**
-         * Destructor.
-         */
         ~RadioButton();
 
         /**
diff --git a/src/gui/widgets/resizegrip.h b/src/gui/widgets/resizegrip.h
index 5ef93f29..319b574f 100644
--- a/src/gui/widgets/resizegrip.h
+++ b/src/gui/widgets/resizegrip.h
@@ -36,14 +36,8 @@ class Image;
 class ResizeGrip : public gcn::Widget
 {
     public:
-        /**
-         * Constructor.
-         */
         ResizeGrip(const std::string &image = "resize.png");
 
-        /**
-         * Destructor.
-         */
         ~ResizeGrip();
 
         /**
diff --git a/src/gui/widgets/shoplistbox.h b/src/gui/widgets/shoplistbox.h
index 087bdd53..325cb562 100644
--- a/src/gui/widgets/shoplistbox.h
+++ b/src/gui/widgets/shoplistbox.h
@@ -37,9 +37,6 @@ class ItemPopup;
 class ShopListBox : public ListBox
 {
     public:
-        /**
-         * Constructor.
-         */
         ShopListBox(gcn::ListModel *listModel);
 
         /**
@@ -47,9 +44,6 @@ class ShopListBox : public ListBox
          */
         ShopListBox(gcn::ListModel *listModel, ShopItems *shopListModel);
 
-        /**
-         * Destructor
-         */
         ~ShopListBox();
 
         /**
diff --git a/src/gui/widgets/shortcutcontainer.h b/src/gui/widgets/shortcutcontainer.h
index 9404ffd2..e511d7f9 100644
--- a/src/gui/widgets/shortcutcontainer.h
+++ b/src/gui/widgets/shortcutcontainer.h
@@ -38,14 +38,8 @@ class ShortcutContainer : public gcn::Widget,
                           public gcn::MouseListener
 {
     public:
-        /**
-         * Constructor. Initializes the shortcut container.
-         */
         ShortcutContainer();
 
-        /**
-         * Destructor.
-         */
         ~ShortcutContainer() {}
 
         /**
diff --git a/src/gui/widgets/slider.h b/src/gui/widgets/slider.h
index 9b26e404..408210ac 100644
--- a/src/gui/widgets/slider.h
+++ b/src/gui/widgets/slider.h
@@ -31,7 +31,8 @@ class Image;
  *
  * \ingroup GUI
  */
-class Slider : public gcn::Slider {
+class Slider : public gcn::Slider
+{
     public:
         /**
          * Constructor with scale start equal to 0.
@@ -40,12 +41,12 @@ class Slider : public gcn::Slider {
 
         /**
          * Constructor.
+         *
+         * @param scaleStart The minimum value of the slider
+         * @param scaleEnd   The maximum value of the slider
          */
         Slider(double scaleStart, double scaleEnd);
 
-        /**
-         * Destructor.
-         */
         ~Slider();
 
         /**
diff --git a/src/gui/widgets/tabbedarea.h b/src/gui/widgets/tabbedarea.h
index 19393f8b..d364eac5 100644
--- a/src/gui/widgets/tabbedarea.h
+++ b/src/gui/widgets/tabbedarea.h
@@ -39,9 +39,6 @@ class Tab;
 class TabbedArea : public gcn::TabbedArea, public gcn::WidgetListener
 {
     public:
-        /**
-         * Constructor.
-         */
         TabbedArea();
 
         /**
diff --git a/src/gui/widgets/textbox.h b/src/gui/widgets/textbox.h
index 3b6778d2..6b947e0b 100644
--- a/src/gui/widgets/textbox.h
+++ b/src/gui/widgets/textbox.h
@@ -34,9 +34,6 @@
 class TextBox : public gcn::TextBox
 {
     public:
-        /**
-         * Constructor.
-         */
         TextBox();
 
         inline void setTextColor(const gcn::Color *color)