Some random dox fixes: keep @param in sync with the parameter names.

svn path=/trunk/KDE/kdeedu/kwordquiz/src/keduvocdocument.h; revision=473878

diff --git a/kwordquiz/keduvocdocument.h b/kwordquiz/keduvocdocument.h
index c41400a8786ac17be9019b67523f19ec27f7d16d..e147ccbde0244322ffaea518eaebee18a9e3c555 100644 (file)
--- a/kwordquiz/keduvocdocument.h
+++ b/kwordquiz/keduvocdocument.h
@@ -267,7 +267,7 @@ class KEduVocDocument : public QObject
 
   /** Constructor for a KdeEdu vocabulary document
    *
-   * @param obj calling object
+   * @param parent calling object
    */
   KEduVocDocument(QObject* parent);
 
@@ -282,14 +282,14 @@ class KEduVocDocument : public QObject
 
   /** appends a new expression to the end of the vocabulary
    *
-   * @param expr            expression to append
+   * @param expression            expression to append
    */
   inline void appendEntry (KEduVocExpression *expression)
     { m_vocabulary.append(*expression); m_dirty = true; }
 
   /** inserts a new expression
    *
-   * @param expr            expression to insert
+   * @param expression            expression to insert
    * @param index           index of entry
    */
   inline void insertEntry(KEduVocExpression *expression, int index)
@@ -437,7 +437,11 @@ class KEduVocDocument : public QObject
 
   /** open a document file
    *
-   * @param url
+   * @param url      url to file to open
+   * @param append   if @c true, the words from @p url are appended to the
+   *                 existing collection; if @c false, the collection is
+   *                 emptied first so that only the words from @p url
+   *                 are in the result.
    * @result         true if successful
    */
   bool open(const KURL& url, bool append);

diff --git a/kwordquiz/keduvocexpression.h b/kwordquiz/keduvocexpression.h
index 2e3087d77dc6e6457e69e165551ba6b45624b9f1..77177995df30d31862fa1d1f12b50d20898b55e2 100644 (file)
--- a/kwordquiz/keduvocexpression.h
+++ b/kwordquiz/keduvocexpression.h
@@ -83,7 +83,7 @@ class KEduVocExpression
   /** adds a new translation of this entry
    * @param expression       translation
    * @param grade            grade of knowledge of this translation
-   * @param rev_grade        dito, in opposite direction
+   * @param reverseGrade     dito, in opposite direction
    */
   void addTranslation(const QString & expression, grade_t grade = KV_NORM_GRADE, grade_t reverseGrade = KV_NORM_GRADE);