Merge pull request #426 from Esri/ldanzinger/doc_fix

fixing docs from doc build

Author: JamesMBallard

uitools/cpp/Esri/ArcGISRuntime/Toolkit/OverviewMapController.cpp

@@ -192,7 +192,10 @@ namespace Toolkit {
   }
 
   /*!
-    \brief Sets the symbol used to represent the GeoView's current viewpoint.
+    \brief Sets the \a symbol used to represent the GeoView's current viewpoint.
+
+     For MapView, the default is an empty SimpleFillSymbol with a 1 point red outline;
+     for SceneView, it will be a red, cross-hair SimpleMarkerSymbol.
    */
   void OverviewMapController::setSymbol(Symbol* symbol)
   {
@@ -220,6 +223,10 @@ namespace Toolkit {
 
   /*!
     \brief Sets the amount to scale the OverviewMap compared to the geoView.
+
+    \list
+      \li \a scaleFactor The scale factor. Defaults to 25.0.
+    \endlist
    */
   void OverviewMapController::setScaleFactor(double scaleFactor)
   {

uitools/cpp/Esri/ArcGISRuntime/Toolkit/PopupViewController.cpp

@@ -251,12 +251,12 @@ void PopupViewController::setAttachmentThumbnailHeight(int height)
  */
 
 /*!
-  \fn void Esri::ArcGISRuntime::Toolkit::PopupViewController::attachmentWidthChanged()
+  \fn void Esri::ArcGISRuntime::Toolkit::PopupViewController::attachmentThumbnailWidthChanged()
   \brief Signal emitted when the attachment minimum width changes.
  */
 
 /*!
-  \fn void Esri::ArcGISRuntime::Toolkit::PopupViewController::attachmentHeightChanged()
+  \fn void Esri::ArcGISRuntime::Toolkit::PopupViewController::attachmentThumbnailHeightChanged()
   \brief Signal emitted when the attachment minimum height changes.
  */
 

uitools/import/Esri/ArcGISRuntime/Toolkit/Controller/BasemapGalleryController.qml

@@ -100,6 +100,8 @@ QtObject {
       \brief Convenience function that appends a basemap to the gallery with an overloaded
       thumbnail and tooltip.
 
+      Returns whether the append was successful.
+
       \list
       \li \a basemap Basemap to add to the gallery.
       \li \a thumbnailUrl Thumbnail to display in the gallery. Optional.

uitools/import/Esri/ArcGISRuntime/Toolkit/Controller/CurrentVersion.qml

@@ -16,7 +16,7 @@
 
 import QtQml 2.12
 
-/*!
+/*
   \internal
   This QML file is only used for incrementing the current version of the toolkit and
   should not be used in your application.

uitools/register/Esri/ArcGISRuntime/Toolkit/register.cpp

@@ -26,7 +26,7 @@
 */
 
 /*!
-  \fn void Esri::ArcGISRuntime::Toolkit::registerComponents(QmlEngine&)
+  \fn void Esri::ArcGISRuntime::Toolkit::registerComponents(QmlEngine& engine)
   \relates Esri/ArcGISRuntime/Toolkit/register
   \brief This registration function must be called after the QmlEngine has been
   declared, but before it is run. This sets up resources and component registration

uitools/widgets/Esri/ArcGISRuntime/Toolkit/Internal/UserCredentialView.cpp

@@ -23,9 +23,21 @@ namespace Esri {
 namespace ArcGISRuntime {
 namespace Toolkit {
 
+/*!
+  \class Esri::ArcGISRuntime::Toolkit::UserCredentialView
+  \inmodule EsriArcGISRuntimeToolkit
+  \ingroup ArcGISQtToolkitUiCppWidgetsViews
+  \brief The user interface for displaying a username/password sign-in dialog.
+
+  This will be used by the AuthenticationView for Token, HTTP Basic, HTTP Digest,
+  and IWA logins.
+ */
+
   /*!
+  \fn UserCredentialView::UserCredentialView(AuthenticationController*, QWidget*)
   \brief Constructor.
   \list
+    \li \a controller The authentication challenge controller.
     \li \a parent Parent widget.
   \endlist
  */