Fixed warnings from clang -Wdocumentation

Change-Id: Ib3ed1d3733ccfd78780640d70e14313d0cbb101f
Reviewed-by: Erik Verbruggen <erik.verbruggen@digia.com>

src/libs/cplusplus/TypeOfExpression.h

@@ -76,7 +76,7 @@ public:
      * expression evaluator instance still exists, and no new call to evaluate
      * has been made!
      *
-     * @param expression        The expression to evaluate.
+     * @param utf8code          The code of expression to evaluate.
      * @param scope             The scope enclosing the expression.
      */
     QList<LookupItem> operator()(const QByteArray &utf8code,

src/libs/utils/json.cpp

@@ -353,8 +353,7 @@ int JsonSchema::itemArraySchemaSize() const
  *
  * The method also marks the context as being inside an array evaluation.
  *
- * \param index
- * \return whether it was necessary to "enter" a schema for the supplied array index
+ * \return whether it was necessary to "enter" a schema for the supplied array index, false if index is out of bounds
  */
 bool JsonSchema::maybeEnterNestedArraySchema(int index)
 {

src/plugins/classview/classviewmanager.h

@@ -57,7 +57,7 @@ class Manager : public QObject
 
 public:
     /*!
-       \brief
+       \brief Creates shared instance
        \param parent Parent object
      */
     explicit Manager(QObject *parent = 0);
@@ -132,8 +132,8 @@ public slots:
     /*!
        \brief Open text editor for file \a fileName on line \a lineNumber and column \a column.
        \param fileName File which has to be open
-       \param lineNumber Line
-       \param column Column
+       \param line Line number, 1-based
+       \param column Column, 1-based
      */
     void gotoLocation(const QString &fileName, int line = 0, int column = 0);
 
@@ -227,7 +227,7 @@ protected:
 
     /*!
        \brief Set internal Manager state.
-       \param true if Manager has to be enabled, false otherwise
+       \param state true if Manager has to be enabled, false otherwise
        \sa state, stateChanged
      */
     void setState(bool state);

src/plugins/classview/classviewnavigationwidget.h

@@ -112,7 +112,7 @@ public slots:
 
     /*!
        \brief Receive a new data for the tree
-       \param Result - root item
+       \param result Pointer to the Class View model root item, method does nothing if null passed
      */
     void onDataUpdate(QSharedPointer<QStandardItem> result);
 
@@ -125,8 +125,8 @@ public slots:
 protected:
     /*!
        \brief Fetch data for expanded items - to be sure that content will exist
-       \param item
-       \param target
+       \param item - does nothing if null
+       \param target - does nothing if null
      */
     void fetchExpandedItems(QStandardItem *item, const QStandardItem *target) const;
 

src/plugins/classview/classviewsymbolinformation.h

@@ -40,7 +40,7 @@ namespace Internal {
 
 /*!
    \class SymbolInformation
-   \brief
+   \brief Provides name, type and icon for single item in Class View tree
  */
 
 class SymbolInformation

src/plugins/classview/classviewutils.h

@@ -82,7 +82,7 @@ public:
 
     /*!
        \brief Set symbol information to the \a QStandardItem
-       \param information
+       \param information Provides name, type and icon
        \param item Item
        \return Filled item
      */

src/plugins/imageviewer/imagevieweractionhandler.h

@@ -60,9 +60,7 @@ protected:
       \param actionId Action's internal id
       \param id Command id
       \param title Action's title
-      \param context Current context
-      \param key Key sequence for the command
-      \return Created and registered action, 0 if something goes wrong
+      \param key Key sequence for the commands
      */
     void registerNewAction(int actionId, const Core::Id &id, const QString &title,
                            const QKeySequence &key);