Lots of missing docs in qtlocation.git

Running qdoc in the qtlocation repo (make html_docs) generates a lot of warnings about missing documenation. Most of them are connected to recent API additions/changes and those need fixing:

cd positioning/ && ( test -e Makefile || /home/ablasche/dev/qt/qt513/qtbase/bin/qmake -o Makefile /home/ablasche/dev/qt/qt513/qtlocation/src/positioning/positioning.pro ) && make -f Makefile generate_docs
make[3]: Entering directory '/home/ablasche/dev/qt/qt513/qtlocation/src/positioning'
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qdoc_wrapper.sh -outputdir /home/ablasche/dev/qt/qt513/qtbase/doc/qtpositioning -installdir /home/ablasche/dev/qt/qt513/qtbase/doc /home/ablasche/dev/qt/qt513/qtlocation/src/positioning/doc/qtpositioning.qdocconf -generate -indexdir /home/ablasche/dev/qt/qt513/qtbase/doc -I. -I../3rdparty/clipper -I../3rdparty/clip2tri -I/home/ablasche/dev/qt/qt513/qtbase/include -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning/5.13.0/QtPositioning -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/5.13.0/QtCore -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore -I.moc -I/home/ablasche/dev/qt/qt513/qtbase/mkspecs/linux-g++
10:06:19 LOG: Start qdoc for QtPositioning in dual process mode, (generate phase)
10:06:20 LOG: Build & visit PCH for QtPositioning
/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/../../src/corelib/kernel/qtimer.h:104:29: error: class member cannot be redeclared
/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/../../src/corelib/kernel/qtimer.h:102:29: note: previous declaration is here
10:06:21 LOG: PCH built & visited for QtPositioning
10:06:21 LOG: Parse source files for QtPositioning
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/doc/src/qtpositioning-plugins.qdoc:41: (qdoc) warning: qtpositioning-plugins.qdocUnable to parse JavaScript: "Expected token `,'" at line 2, column 11
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeocoordinate.cpp:321: (qdoc) warning: clang found diagnostics parsing \fn bool QGeoCoordinate::operator!=(const QGeoCoordinateObject &other) const
error: unknown type name 'QGeoCoordinateObject'
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeocoordinate.cpp:321: (qdoc) warning: clang found diagnostics parsing \fn bool QGeoCoordinate::operator!=(const QGeoCoordinateObject *other) const
error: unknown type name 'QGeoCoordinateObject'
/home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick/qdeclarativegeoaddress.cpp:44: (qdoc) warning: C++ class QDeclarativeGeoAddress not found: \instantiates QDeclarativeGeoAddress
/home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick/qdeclarativegeolocation.cpp:44: (qdoc) warning: C++ class QDeclarativeGeoLocation not found: \instantiates QDeclarativeGeoLocation
/home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick/qquickgeocoordinateanimation.cpp:49: (qdoc) warning: C++ class QQuickGeoCoordinateAnimation not found: \instantiates QQuickGeoCoordinateAnimation
10:06:21 LOG: Source files parsed for QtPositioning
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeolocation.cpp:208: (qdoc) warning: Undocumented parameter 'data' in QGeoLocation::setExtendedAttributes()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:119: (qdoc) warning: No such parameter 'polygon' in QGeoPolygon::QGeoPolygon()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:357: (qdoc) warning: Undocumented parameter 'holePath' in QGeoPolygon::addHole()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:357: (qdoc) warning: No such parameter 'path' in QGeoPolygon::addHole()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:377: (qdoc) warning: No such parameter 'path' in QGeoPolygon::addHole()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:388: (qdoc) warning: Undocumented parameter 'index' in QGeoPolygon::hole()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:180: (qdoc) warning: Undocumented parameter 'path' in QGeoPolygon::setPath()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:180: (qdoc) warning: No such parameter 'polygon' in QGeoPolygon::setPath()
/home/ablasche/dev/qt/qt513/qtlocation/src/positioning/qgeopolygon.cpp:198: (qdoc) warning: Undocumented parameter 'path' in QGeoPolygon::setPerimeter()
/home/ablasche/dev/qt/qt513/qtlocation/examples/positioning/geoflickr/doc/src/geoflickr.qdoc:28: (qdoc) warning: Can't link to 'XmlListModel'
/home/ablasche/dev/qt/qt513/qtlocation/src/imports/positioning/locationsingleton.cpp:376: (qdoc) warning: Undocumented parameter 'coord' in QtPositioning::coordToMercator()
/home/ablasche/dev/qt/qt513/qtlocation/src/imports/positioning/locationsingleton.cpp:99: (qdoc) warning: No such parameter 'longitude' in QtPositioning::coordinate()
[Maybe you meant 'longitue'?]
/home/ablasche/dev/qt/qt513/qtlocation/src/imports/positioning/locationsingleton.cpp:363: (qdoc) warning: Undocumented parameter 'mercator' in QtPositioning::mercatorToCoord()
/home/ablasche/dev/qt/qt513/qtlocation/src/imports/positioning/locationsingleton.cpp:150: (qdoc) warning: No such parameter 'bottomLeft' in QtPositioning::rectangle()
10:06:21 LOG: End qdoc for QtPositioning in dual process mode, (generate phase)
make[3]: Leaving directory '/home/ablasche/dev/qt/qt513/qtlocation/src/positioning'
cd positioningquick/ && ( test -e Makefile || /home/ablasche/dev/qt/qt513/qtbase/bin/qmake -o Makefile /home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick/positioningquick.pro ) && make -f Makefile generate_docs
make[3]: Entering directory '/home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick'
make[3]: Nothing to be done for 'generate_docs'.
make[3]: Leaving directory '/home/ablasche/dev/qt/qt513/qtlocation/src/positioningquick'
cd location/ && ( test -e Makefile || /home/ablasche/dev/qt/qt513/qtbase/bin/qmake -o Makefile /home/ablasche/dev/qt/qt513/qtlocation/src/location/location.pro ) && make -f Makefile generate_docs
make[3]: Entering directory '/home/ablasche/dev/qt/qt513/qtlocation/src/location'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/qdoc_wrapper.sh -outputdir /home/ablasche/dev/qt/qt513/qtbase/doc/qtlocation -installdir /home/ablasche/dev/qt/qt513/qtbase/doc /home/ablasche/dev/qt/qt513/qtlocation/src/location/doc/qtlocation.qdocconf -generate -indexdir /home/ablasche/dev/qt/qt513/qtbase/doc -I. -I../3rdparty/earcut -I../3rdparty/poly2tri -I../3rdparty/clipper -I../3rdparty/clip2tri -I../positioning -I../imports/positioning -I. -Imaps -Iplaces -Ideclarativemaps -Ideclarativeplaces -Ilabs -I/home/ablasche/dev/qt/qt513/qtbase/include -I/home/ablasche/dev/qt/qt513/qtbase/include/QtLocation -I/home/ablasche/dev/qt/qt513/qtbase/include/QtLocation/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtLocation/5.13.0/QtLocation -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioningQuick/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioningQuick/5.13.0/QtPositioningQuick -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning/5.13.0/QtPositioning -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQuick/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQuick/5.13.0/QtQuick -I/home/ablasche/dev/qt/qt513/qtbase/include/QtGui/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtGui/5.13.0/QtGui -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQml/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQml/5.13.0/QtQml -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/5.13.0 -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/5.13.0/QtCore -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioningQuick -I/home/ablasche/dev/qt/qt513/qtbase/include/QtPositioning -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQuick -I/home/ablasche/dev/qt/qt513/qtbase/include/QtGui -I/home/ablasche/dev/qt/qt513/qtbase/include/QtQml -I/home/ablasche/dev/qt/qt513/qtbase/include/QtNetwork -I/home/ablasche/dev/qt/qt513/qtbase/include/QtCore -I.moc -isystem /usr/include/libdrm -I/home/ablasche/dev/qt/qt513/qtbase/mkspecs/linux-g++
10:06:22 LOG: Start qdoc for QtLocation in dual process mode, (generate phase)
10:06:24 LOG: Build & visit PCH for QtLocation
/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/../../src/corelib/kernel/qtimer.h:104:29: error: class member cannot be redeclared
/home/ablasche/dev/qt/qt513/qtbase/include/QtCore/../../src/corelib/kernel/qtimer.h:102:29: note: previous declaration is here
/home/ablasche/dev/qt/qt513/qtlocation/src/location/places/qplaceresult.h:53:19: error: extra qualification on member 'QPlaceResult'
10:06:25 LOG: PCH built & visited for QtLocation
10:06:25 LOG: Parse source files for QtLocation
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qgeomapobject.cpp:73: (qdoc) warning: Cannot tie this documentation to anything
[qdoc found a /*! ... */ comment, but there was no topic command (e.g., '\fn', '\page') in the comment and no function definition following the comment.]
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qgeomapobject.cpp:82: (qdoc) warning: Cannot tie this documentation to anything
[qdoc found a /*! ... */ comment, but there was no topic command (e.g., '\fn', '\page') in the comment and no function definition following the comment.]
/home/ablasche/dev/qt/qt513/qtlocation/src/location/doc/src/qtlocation-geoservices.qdoc:42: (qdoc) warning: qtlocation-geoservices.qdocUnable to parse JavaScript: "Expected token `,'" at line 2, column 11
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Invalid use of '\qmlsignal'; not allowed in a '\qmlpropertygroup'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Invalid use of '\qmlsignal'; not allowed in a '\qmlpropertygroup'
10:06:38 LOG: Source files parsed for QtLocation
/home/ablasche/dev/qt/qt513/qtlocation/src/location/maps/qgeorouterequest.cpp:471: (qdoc) warning: Undocumented parameter 'departureTime' in QGeoRouteRequest::setDepartureTime()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/maps/qgeoroute.cpp:302: (qdoc) warning: Undocumented parameter 'legs' in QGeoRoute::setRouteLegs()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/maps/qgeoroute.cpp:770: (qdoc) warning: No such parameter 'route' in QGeoRouteLeg::overallRoute()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/maps/qgeoserviceprovider.cpp:119: (qdoc) warning: Undocumented enum item 'LoaderError' in QGeoServiceProvider::Error
/home/ablasche/dev/qt/qt513/qtlocation/examples/location/itemview_transitions/doc/src/itemview_transitions.qdoc:28: (qdoc) warning: '\brief' statement does not end with a full stop.
/home/ablasche/dev/qt/qt513/qtlocation/examples/location/itemview_transitions/doc/src/itemview_transitions.qdoc:28: (qdoc) warning: Missing image: itemview_transitions.jpg
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeocodemodel.cpp:528: (qdoc) warning: Undocumented parameter 'int' in GeocodeModel::get()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1748: (qdoc) warning: Undocumented parameter 'parameter' in Map::addMapParameter()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1573: (qdoc) warning: Undocumented parameter 'geoShape' in Map::fitViewportToGeoShape()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1573: (qdoc) warning: Undocumented parameter 'margins' in Map::fitViewportToGeoShape()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1507: (qdoc) warning: Undocumented parameter 'clipToViewPort' in Map::fromCoordinate()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1507: (qdoc) warning: No such parameter 'cliptoViewPort' in Map::fromCoordinate()
[Maybe you meant 'clipToViewPort'?]
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1778: (qdoc) warning: Undocumented parameter 'parameter' in Map::removeMapParameter()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1491: (qdoc) warning: Undocumented parameter 'clipToViewPort' in Map::toCoordinate()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeomap.cpp:1491: (qdoc) warning: No such parameter 'cliptoViewPort' in Map::toCoordinate()
[Maybe you meant 'clipToViewPort'?]
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroute.cpp:383: (qdoc) warning: Undocumented parameter 'other' in Route::equals()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroute.cpp:383: (qdoc) warning: Undocumented return value (hint: use 'return' or 'returns' in the text
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:241: (qdoc) warning: Undocumented parameter 'int' in RouteModel::get()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:991: (qdoc) warning: Undocumented parameter 'georectangle' in RouteQuery::addExcludedArea()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:1021: (qdoc) warning: Undocumented parameter 'georectangle' in RouteQuery::removeExcludedArea()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:1115: (qdoc) warning: Undocumented parameter 'coordinate' in RouteQuery::removeWaypoint()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:1195: (qdoc) warning: Undocumented parameter 'FeatureType' in RouteQuery::setFeatureWeight()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativegeoroutemodel.cpp:1195: (qdoc) warning: Undocumented parameter 'FeatureWeight' in RouteQuery::setFeatureWeight()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativepolygonmapitem.cpp:402: (qdoc) warning: Undocumented parameter 'coordinate' in MapPolygon::addCoordinate()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativepolylinemapitem.cpp:849: (qdoc) warning: Undocumented parameter 'coordinate' in MapPolyline::addCoordinate()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qdeclarativepolylinemapitem.cpp:798: (qdoc) warning: Undocumented parameter 'path' in MapPolyline::setPath()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:358: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::pinchFinished()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:337: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::pinchStarted()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:347: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::pinchUpdated()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:434: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::rotationFinished()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:409: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::rotationStarted()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:421: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::rotationUpdated()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:471: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::tiltFinished()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:446: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::tiltStarted()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativemaps/qquickgeomapgesturearea.cpp:458: (qdoc) warning: Undocumented parameter 'event' in MapGestureArea::tiltUpdated()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativeplaces/qdeclarativeplace.cpp:1059: (qdoc) warning: Undocumented parameter 'destinationPlugin' in Place::initializeFavorite()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/declarativeplaces/qdeclarativeplace.cpp:1059: (qdoc) warning: No such parameter 'destination' in Place::initializeFavorite()
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'nextManeuverIcon'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'distanceToNextManeuver'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'remainingTravelDistance'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'remainingTravelDistanceToNextWaypoint'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'traveledDistance'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'timeToNextManeuver'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'remainingTravelTime'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'remainingTravelTimeToNextWaypoint'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'traveledTime'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentRoute'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentRouteSegment'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentRoute'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentRoute'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentSegment'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'currentRoute'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'waypointReached'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:503: (qdoc) warning: Can't link to 'destinationReached'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qdeclarativenavigator.cpp:101: (qdoc) warning: Can't link to 'currentRoute'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qgeojson.cpp:53: (qdoc) warning: Can't link to 'The importer'
/home/ablasche/dev/qt/qt513/qtlocation/src/location/labs/qgeojson.cpp:1233: (qdoc) warning: Undocumented parameter 'geoData' in QGeoJson::toString()