Doc: edit cpptools docs

Remove \briefs from function descriptions and use standard
wording in them.
Use standard wording for \enum.
Replace \param with \a.

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

src/plugins/cpptools/cppmodelmanager.cpp

@@ -198,7 +198,7 @@ void CppModelManager::updateModifiedSourceFiles()
            for each project and all the related CppCodeModelPart instances.
 
     It also takes care of updating the code models when C++ files are
-    modified within Qt Creator.
+    modified within \QC.
 */
 
 QMutex CppModelManager::m_modelManagerMutex;

src/plugins/cpptools/cpppointerdeclarationformatter.cpp

@@ -51,7 +51,7 @@
 using namespace CppTools;
 
 /*!
-   \brief Skip not type relevant specifiers and return the index of the
+   Skips specifiers that are not type relevant and returns the index of the
           first specifier token which is not followed by __attribute__
           ((T___ATTRIBUTE__)).
 
@@ -60,17 +60,20 @@ using namespace CppTools;
 
    Consider these cases:
 
-        static char *s = 0;
-        typedef char *s cp;
-        __attribute__((visibility("default"))) char *f();
+    \list
+        \li \c {static char *s = 0;}
+        \li \c {typedef char *s cp;}
+        \li \c {__attribute__((visibility("default"))) char *f();}
+    \endlist
 
-   For all cases we want to skip all the not type relevant specifer
+   For all these cases we want to skip all the specifiers that are not type
+   relevant
    (since these are not part of the type and thus are not rewritten).
 
-   \param list The specifier list to iterate
-   \param translationUnit The TranslationUnit
-   \param endToken Do not check further than this token
-   \param found Output parameter, must not be 0.
+   \a list is the specifier list to iterate and \a translationUnit is the
+   translation unit.
+   \a endToken is the last token to check.
+   \a found is an output parameter that must not be 0.
  */
 static unsigned firstTypeSpecifierWithoutFollowingAttribute(
     SpecifierListAST *list, TranslationUnit *translationUnit, unsigned endToken, bool *found)
@@ -363,11 +366,8 @@ void PointerDeclarationFormatter::processIfWhileForStatement(ExpressionAST *expr
 }
 
 /*!
-   \brief Do some further checks and rewrite the symbol's type and
-          name into the given range
-
-   \param symbol the symbol to be rewritten
-   \param range the substitution range in the file
+    Performs some further checks and rewrites the type and name of \a symbol
+    into the substitution range in the file specified by \a tokenRange.
  */
 void PointerDeclarationFormatter::checkAndRewrite(DeclaratorAST *declarator,
                                                   Symbol *symbol,

src/plugins/cpptools/cpppointerdeclarationformatter.h

@@ -63,10 +63,10 @@ public:
     /*!
         \enum PointerDeclarationFormatter::CursorHandling
 
-        This simplifies the QuickFix implementation.
+        This enum type simplifies the QuickFix implementation.
 
           \value RespectCursor
-                 Consider the cursor position / selection of the CppRefactoringFile
+                 Consider the cursor position or selection of the CppRefactoringFile
                  for rejecting edit operation candidates for the resulting ChangeSet.
                  If there is a selection, the range of the edit operation candidate
                  should be inside the selection. If there is no selection, the cursor