Doc: Fix documentation warnings

Add a custom module header, used only for documentation builds, that
pulls in also the QtMultimediaWidgets module.

Several documentation fixes to clean up warnings from clang.

Task-number: QTBUG-67790
Change-Id: I6c1013798a648250c8555eb92684ec3b33ff7531
Reviewed-by: Martin Smith <martin.smith@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>

1 files changed, 8 insertions, 7 deletions

diff --git a/src/multimedia/camera/qcamera.cpp b/src/multimedia/camera/qcamera.cpp
index fd804316c..722c5b629 100644
--- a/src/multimedia/camera/qcamera.cpp
+++ b/src/multimedia/camera/qcamera.cpp
@@ -478,11 +478,11 @@ QCameraImageProcessing *QCamera::imageProcessing() const
 }
 
 /*!
-  Sets the QVideoWidget based camera \a viewfinder.
-  The previously set viewfinder is detached.
-*/
+    Sets the QVideoWidget based camera \a viewfinder.
+    The previously set viewfinder is detached.
 
-// QVideoWidget is forward declared
+    //! QVideoWidget is forward declared.
+*/
 void QCamera::setViewfinder(QVideoWidget *viewfinder)
 {
     Q_D(QCamera);
@@ -498,10 +498,11 @@ void QCamera::setViewfinder(QVideoWidget *viewfinder)
 }
 
 /*!
-  Sets the QGraphicsVideoItem based camera \a viewfinder.
-  The previously set viewfinder is detached.
+    Sets the QGraphicsVideoItem based camera \a viewfinder.
+    The previously set viewfinder is detached.
+
+    //! QGraphicsVideoItem is forward declared.
 */
-// QGraphicsVideoItem is forward declared
 void QCamera::setViewfinder(QGraphicsVideoItem *viewfinder)
 {
     Q_D(QCamera);