change and add some comments, remove some warning

[mdictionary] / src / plugins / xdxf / DownloadDict.h

diff --git a/src/plugins/xdxf/DownloadDict.h b/src/plugins/xdxf/DownloadDict.h
index cf6ff57..172d71b 100644 (file)
--- a/src/plugins/xdxf/DownloadDict.h
+++ b/src/plugins/xdxf/DownloadDict.h
@@ -19,10 +19,10 @@
 
 *******************************************************************************/
 
-/*! \file DownloadDict.h
-\brief Represenation of dictionary html entry on XDXF webpage
-
-\author Bartosz Szatkowski <bulislaw@linux.com>
+/*!
+    \file DownloadDict.h
+    \brief Represenation of dictionary html entry on XDXF webpage
+    \author Bartosz Szatkowski <bulislaw@linux.com>
 */
 
 #ifndef DOWNLOADDICT_H
@@ -32,7 +32,7 @@
 #include <QStringList>
 #include <math.h>
 
-/**
+/*!
     Each dictionary is representing as one html line at XDXF webpage,
     each entry contains lang from, lang to, file name, file size, link, etc info
     about dictionary. DownloadDict cut this description and then it may be
@@ -42,12 +42,10 @@ class DownloadDict
 {
 public:
 
-    /** Cuts html entry to class
-
-    Html entry looks like <tr><td>...</td><td>...</tr> some of the fields
-    dosn't matters for now so Iam ignoring it.
-
-    \param html html entry (line describing a dict) to be cut
+    /*! Cuts html entry to class
+        Html entry looks like <tr><td>...</td><td>...</tr> some of the fields
+        dosn't matters for now so Iam ignoring it.
+        \param html html entry (line describing a dict) to be cut
     */
     DownloadDict(QString html) {
         QRegExp reg("<td.*>(.*)</td>");
@@ -64,12 +62,9 @@ public:
         QString sizeStr = tmp.at(3);
 
         _size = sizeStr.remove(',').toInt();
-
         _size = _size / 1024 / 1024;
-
         _size = round(_size*1000) / 1000;
 
-
         QRegExp lreg("href=\"(.*)\""); // Cutting link to file
         lreg.setMinimal(true);
         lreg.indexIn(tmp.at(2));
@@ -88,11 +83,13 @@ public:
     //! \return dictionary archive size
     float size() const {return _size;}
 
-
     //! \return link to dictionary archive
     QString link() const {return _link;}
 
-    //! Compares dict by from lang then to lang \return 1 if this is before other
+    /*!
+        Compares dict by from lang then to lang
+        \return 1 if this is before other
+    */
     bool operator <(DownloadDict other) const {
         if(_from < other.fromLang()) return true;
         if(_from > other.fromLang()) return false;