Doc: Fix more QDoc warnings

Change-Id: Ic7f4170276aa40a32c9394c9fad0d920971bf873
Reviewed-by: Eike Ziller <eike.ziller@qt.io>

src/libs/utils/execmenu.cpp

@@ -44,7 +44,8 @@ QAction *execMenuAtWidget(QMenu *menu, QWidget *widget)
 }
 
 /*!
-    Adds tool tips to the menu that show the actions tool tip when hovering over an entry.
+    Adds tool tips to the \a menu that show the action's tool tip when hovering
+    over an entry.
  */
 void addToolTipsToMenu(QMenu *menu)
 {

src/plugins/coreplugin/editormanager/editormanager.cpp

@@ -261,10 +261,10 @@ void EditorManagerPlaceHolder::showEvent(QShowEvent *)
 */
 
 /*!
-    \fn void Core::EditorManager::editorCreated(Core::IEditor *editor, const QString &fileName)
+    \fn void Core::EditorManager::editorCreated(Core::IEditor *editor, const Utils::FilePath &filePath)
 
-    This signal is emitted after an \a editor was created for \a fileName, but
-    before it was opened in an editor view.
+    This signal is emitted after an \a editor was created for the file at
+    \a filePath, but before it was opened in an editor view.
 */
 /*!
     \fn void Core::EditorManager::editorOpened(Core::IEditor *editor)

src/plugins/coreplugin/editormanager/ieditorfactory.cpp

@@ -47,23 +47,23 @@ static void mimeTypeFactoryLookup(const Utils::MimeType &mimeType,
     \brief The IEditorFactory class creates suitable editors for documents
     according to their MIME type.
 
-    Whenever a user wants to edit or create a document, the EditorManager
-    scans all IEditorFactory instances for suitable editors. The selected
-    IEditorFactory is then asked to create an editor.
+    When a user wants to edit or create a document, the EditorManager
+    scans all IEditorFactory instances for suitable editors and selects one
+    to create an editor.
 
     Implementations should set the properties of the IEditorFactory subclass in
     their constructor with IEditorFactory::setId(), IEditorFactory::setDisplayName(),
-    IEditorFactory::setMimeTypes(), and setEditorCreator()
+    IEditorFactory::setMimeTypes(), and IEditorFactory::setEditorCreator().
 
     IEditorFactory instances automatically register themselves in \QC in their
     constructor.
 
-    There are two varieties of editors: Internal and external. Internal editors
-    open within the main editing area of Qt Creator. An IEditorFactory defines
-    an internal editor by using the \c setEditorCreator function. External
+    There are two varieties of editors: internal and external. Internal editors
+    open within the main editing area of \QC. An IEditorFactory instance defines
+    an internal editor by using the setEditorCreator() function. External
     editors are external applications and are defined by using the
-    \c setEditorStarter function. They are accessible by the user using
-    the \uicontrol{Open With} dialog
+    setEditorStarter() function. The user can access them from the
+    \uicontrol{Open With} dialog.
 
     \sa Core::IEditor
     \sa Core::IDocument
@@ -167,7 +167,7 @@ IEditorFactory *IEditorFactory::editorFactoryForId(const Utils::Id &id)
 
 /*!
     Returns all available internal and external editors for the \a mimeType in the
-    default order: Editor types ordered by MIME type hierarchy, internal editors
+    default order: editor types are ordered by MIME type hierarchy, internal editors
     first.
 */
 const EditorFactories IEditorFactory::defaultEditorFactories(const MimeType &mimeType)
@@ -283,9 +283,10 @@ IEditor *IEditorFactory::createEditor() const
 }
 
 /*!
-    Starts an external editor.
+    Opens the file at \a filePath in an external editor.
 
-    Uses the function set with setEditorStarter() to start the editor.
+    Returns \c true on success or \c false on failure with the error in
+    \a errorMessage.
 
     \sa setEditorStarter()
 */
@@ -299,7 +300,7 @@ bool IEditorFactory::startEditor(const FilePath &filePath, QString *errorMessage
     Sets the function that is used to create an editor instance in
     createEditor() to \a creator.
 
-    This is mutually exclusive with the use of setEditorStarter.
+    This is mutually exclusive with the use of setEditorStarter().
 
     \sa createEditor()
 */
@@ -313,12 +314,16 @@ void IEditorFactory::setEditorCreator(const std::function<IEditor *()> &creator)
 }
 
 /*!
-    Opens the editor with \a fileName. Returns \c true on success or \c false
-    on failure along with the error in \a errorMessage.
+    \fn void Core::IEditorFactory::setEditorStarter(const std::function<bool(const Utils::FilePath &, QString *)> &starter);
 
-    This is mutually exclusive with the use of setEditorCreator.
+    Sets the function that is used to open a file for a given \c FilePath to
+    \a starter.
+
+    The function should return \c true on success, or return \c false and set the
+    \c QString to an error message at failure.
+
+    This is mutually exclusive with the use of setEditorCreator().
 */
-
 void IEditorFactory::setEditorStarter(const std::function<bool(const FilePath &, QString *)> &starter)
 {
     QTC_CHECK(!m_starter);

src/plugins/coreplugin/icore.cpp

@@ -570,8 +570,6 @@ bool ICore::showWarningWithOptions(const QString &title, const QString &text,
     If \a scope is \c QSettings::SystemScope, only the installation settings
     shipped with the current version of \QC will be read. This
     functionality exists for internal purposes only.
-
-    \sa settingsDatabase()
 */
 QtcSettings *ICore::settings(QSettings::Scope scope)
 {

src/plugins/coreplugin/iversioncontrol.cpp

@@ -143,7 +143,7 @@ QString IVersionControl::refreshTopic(const FilePath &repository)
     it will be used. Otherwise it will be refreshed using the items provided by
     \c setTopicFileTracker() and \c setTopicRefresher().
 
-    \sa setTopicFileTracker(), setTopicRefresher().
+    \sa setTopicFileTracker(), setTopicRefresher()
  */
 
 QString IVersionControl::vcsTopic(const FilePath &topLevel)

src/plugins/coreplugin/progressmanager/progressmanager.cpp

@@ -768,7 +768,7 @@ FutureProgress *ProgressManager::addTask(const QFuture<void> &future, const QStr
     Shows a progress indicator for task given by the QFutureInterface object
     \a futureInterface.
     The progress indicator shows the specified \a title along with the progress bar.
-    The progress indicator will increase monotonically with time, at \a expectedSeconds
+    The progress indicator will increase monotonically with time, at \a expectedDuration
     it will reach about 80%, and continue to increase with a decreasingly slower rate.
 
     The \a type of a task will specify a logical grouping with other