diff --git a/include/entry.h b/include/entry.h
index af9067e29..c47d33912 100644
--- a/include/entry.h
+++ b/include/entry.h
@@ -50,7 +50,7 @@ class Entry
     /**
      * Construct an entry making reference to an zim article.
      *
-     * @param article
+     * @param article a zim::Article object
      */
     Entry(zim::Article article);
     virtual ~Entry() = default;
diff --git a/include/reader.h b/include/reader.h
index 52f8c0ec2..4301ea35c 100644
--- a/include/reader.h
+++ b/include/reader.h
@@ -280,7 +280,7 @@ class Reader
    * Get the mimetype of a entry specified by a url.
    *
    * @param[in] url the url of the entry.
-   * @param[out] mimetype the mimeType of the entry.
+   * @param[out] mimeType the mimeType of the entry.
    * @return True if the mimeType has been found.
    */
   DEPRECATED bool getMimeTypeByUrl(const string& url, string& mimeType) const;
@@ -356,7 +356,7 @@ class Reader
    * `getNextSuggestion` method.
    *
    * @param prefix The prefix to search.
-   * @param suggestionCount How many suggestions to search for.
+   * @param suggestionsCount How many suggestions to search for.
    * @param reset If true, remove previous suggestions in the internal vector.
    *              If false, add suggestions to the internal vector
    *              (until internal vector size is suggestionCount (or no more
@@ -380,7 +380,7 @@ class Reader
    * The internal vector will be reset.
    *
    * @param prefix The prefix to search for.
-   * @param suggestionCount How many suggestions to search for.
+   * @param suggestionsCount How many suggestions to search for.
    */
   bool searchSuggestionsSmart(const string& prefix,
                               unsigned int suggestionsCount);