Fix doxygen warnings

This commit is contained in:
Nyall Dawson 2017-10-05 13:40:11 +10:00
parent 49b426d951
commit 78c0c28468
6 changed files with 19 additions and 16 deletions

View File

@ -126,9 +126,9 @@ Return index for a given node. If the node does not belong to the layer tree, th
QList<QgsLayerTreeNode *> indexes2nodes( const QModelIndexList &list, bool skipInternal = false ) const; QList<QgsLayerTreeNode *> indexes2nodes( const QModelIndexList &list, bool skipInternal = false ) const;
%Docstring %Docstring
Convert a list of indexes to a list of layer tree nodes. Convert a ``list`` of indexes to a list of layer tree nodes.
Indices that do not represent layer tree nodes are skipped. Indices that do not represent layer tree nodes are skipped.
\param skipInternal If true, a node is included in the output list only if no parent node is in the list If ``skipInternal`` is true, a node is included in the output list only if no parent node is in the list.
:rtype: list of QgsLayerTreeNode :rtype: list of QgsLayerTreeNode
%End %End

View File

@ -32,10 +32,12 @@ class QgsPointLocator : QObject
explicit QgsPointLocator( QgsVectorLayer *layer, const QgsCoordinateReferenceSystem &destinationCrs = QgsCoordinateReferenceSystem(), explicit QgsPointLocator( QgsVectorLayer *layer, const QgsCoordinateReferenceSystem &destinationCrs = QgsCoordinateReferenceSystem(),
const QgsRectangle *extent = 0 ); const QgsRectangle *extent = 0 );
%Docstring %Docstring
Construct point locator for a layer. Construct point locator for a ``layer``.
\param destinationCrs if a valid QgsCoordinateReferenceSystem is passed then the locator will
do the searches on data reprojected to the given CRS If a valid QgsCoordinateReferenceSystem is passed for ``destinationCrs`` then the locator will
\param extent if not null, will index only a subset of the layer do the searches on data reprojected to the given CRS.
If ``extent`` is not null, the locator will index only a subset of the layer which falls within that extent.
%End %End
~QgsPointLocator(); ~QgsPointLocator();

View File

@ -127,9 +127,9 @@ class CORE_EXPORT QgsLayerTreeModel : public QAbstractItemModel
QModelIndex node2index( QgsLayerTreeNode *node ) const; QModelIndex node2index( QgsLayerTreeNode *node ) const;
/** /**
* Convert a list of indexes to a list of layer tree nodes. * Convert a \a list of indexes to a list of layer tree nodes.
* Indices that do not represent layer tree nodes are skipped. * Indices that do not represent layer tree nodes are skipped.
* \param skipInternal If true, a node is included in the output list only if no parent node is in the list * If \a skipInternal is true, a node is included in the output list only if no parent node is in the list.
*/ */
QList<QgsLayerTreeNode *> indexes2nodes( const QModelIndexList &list, bool skipInternal = false ) const; QList<QgsLayerTreeNode *> indexes2nodes( const QModelIndexList &list, bool skipInternal = false ) const;

View File

@ -51,10 +51,12 @@ class CORE_EXPORT QgsPointLocator : public QObject
Q_OBJECT Q_OBJECT
public: public:
/** Construct point locator for a layer. /** Construct point locator for a \a layer.
* \param destinationCrs if a valid QgsCoordinateReferenceSystem is passed then the locator will *
* do the searches on data reprojected to the given CRS * If a valid QgsCoordinateReferenceSystem is passed for \a destinationCrs then the locator will
* \param extent if not null, will index only a subset of the layer * do the searches on data reprojected to the given CRS.
*
* If \a extent is not null, the locator will index only a subset of the layer which falls within that extent.
*/ */
explicit QgsPointLocator( QgsVectorLayer *layer, const QgsCoordinateReferenceSystem &destinationCrs = QgsCoordinateReferenceSystem(), explicit QgsPointLocator( QgsVectorLayer *layer, const QgsCoordinateReferenceSystem &destinationCrs = QgsCoordinateReferenceSystem(),
const QgsRectangle *extent = nullptr ); const QgsRectangle *extent = nullptr );

View File

@ -985,7 +985,7 @@ QStringList QgsProjectionSelectionTreeWidget::authorities()
return authorities; return authorities;
} }
const QString QgsProjectionSelectionTreeWidget::sqlSafeString( const QString &theSQL ) QString QgsProjectionSelectionTreeWidget::sqlSafeString( const QString &theSQL ) const
{ {
QString retval = theSQL; QString retval = theSQL;
retval.replace( '\\', QLatin1String( "\\\\" ) ); retval.replace( '\\', QLatin1String( "\\\\" ) );

View File

@ -155,15 +155,14 @@ class GUI_EXPORT QgsProjectionSelectionTreeWidget : public QWidget, private Ui::
void loadCrsList( QSet<QString> *crsFilter = nullptr ); void loadCrsList( QSet<QString> *crsFilter = nullptr );
/** /**
* \brief Make the string safe for use in SQL statements. * \brief Makes a \a string safe for use in SQL statements.
* This involves escaping single quotes, double quotes, backslashes, * This involves escaping single quotes, double quotes, backslashes,
* and optionally, percentage symbols. Percentage symbols are used * and optionally, percentage symbols. Percentage symbols are used
* as wildcards sometimes and so when using the string as part of the * as wildcards sometimes and so when using the string as part of the
* LIKE phrase of a select statement, should be escaped. * LIKE phrase of a select statement, should be escaped.
* \param const QString in The input string to make safe.
* \returns The string made safe for SQL statements. * \returns The string made safe for SQL statements.
*/ */
const QString sqlSafeString( const QString &theSQL ); QString sqlSafeString( const QString &string ) const;
/** /**
* \brief converts the CRS group to a SQL expression fragment * \brief converts the CRS group to a SQL expression fragment