Skip to content

Commit

Permalink
Don't try to insert links in raises blocks in PyQGIS docs
Browse files Browse the repository at this point in the history
These aren't formatted correctly if we do
  • Loading branch information
nyalldawson committed Jun 10, 2021
1 parent 8359281 commit 4ff3f44
Show file tree
Hide file tree
Showing 35 changed files with 121 additions and 121 deletions.
4 changes: 2 additions & 2 deletions python/core/auto_generated/geometry/qgscurvepolygon.sip.in
Expand Up @@ -95,7 +95,7 @@ Returns the curve polygon's exterior ring.
%Docstring
Retrieves an interior ring from the curve polygon. The first interior ring has index 0.

:raises IndexError: if no interior ring with the specified index exists.
:raises `IndexError` if no interior ring with the specified index exists.

.. seealso:: :py:func:`numInteriorRings`

Expand Down Expand Up @@ -151,7 +151,7 @@ Removes an interior ring from the polygon. The first interior ring has index 0.
The corresponding ring is removed from the polygon and deleted.
It is not possible to remove the exterior ring using this method.

:raises IndexError: if no interior ring with the specified index exists.
:raises `IndexError` if no interior ring with the specified index exists.

.. seealso:: :py:func:`removeInteriorRings`
%End
Expand Down
40 changes: 20 additions & 20 deletions python/core/auto_generated/geometry/qgsgeometry.sip.in
Expand Up @@ -577,7 +577,7 @@ In case of error -1 will be returned.

This method requires a QGIS build based on GEOS 3.7 or later.

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.6 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.6 or earlier.

.. seealso:: :py:func:`frechetDistanceDensify`

Expand All @@ -603,7 +603,7 @@ distance returned approach the true Fréchet distance for the geometries.

This method requires a QGIS build based on GEOS 3.7 or later.

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.6 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.6 or earlier.

.. seealso:: :py:func:`frechetDistance`

Expand Down Expand Up @@ -1415,7 +1415,7 @@ This method requires QGIS builds based on GEOS 3.9 or later.

the ``tolerance`` value must be a value greater than 0, or the algorithm may never converge on a solution

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.8 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.8 or earlier.


.. versionadded:: 3.20
Expand All @@ -1432,7 +1432,7 @@ can be moved through, with a single rotation.

This method requires a QGIS build based on GEOS 3.6 or later.

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.

.. versionadded:: 3.20
%End
Expand All @@ -1455,7 +1455,7 @@ If an error occurs while calculating the clearance NaN will be returned.

This method requires a QGIS build based on GEOS 3.6 or later.

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.

.. versionadded:: 3.20
%End
Expand All @@ -1468,7 +1468,7 @@ If the geometry has no minimum clearance, an empty LineString will be returned.

This method requires a QGIS build based on GEOS 3.6 or later.

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on GEOS 3.5 or earlier.

.. versionadded:: 3.20
%End
Expand Down Expand Up @@ -1696,9 +1696,9 @@ is 0, then a completely random sequence of points will be generated.

This method works only with (multi)polygon geometry types.

:raises TypeError: if the geometry is not a polygon type
:raises `TypeError` if the geometry is not a polygon type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null

.. versionadded:: 3.10
%End
Expand Down Expand Up @@ -1827,9 +1827,9 @@ Any z or m values present in the geometry will be discarded.

This method works only with single-point geometry types.

:raises TypeError: if the geometry is not a single-point type
:raises `TypeError` if the geometry is not a single-point type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down Expand Up @@ -1859,9 +1859,9 @@ Any z or m values present in the geometry will be discarded. If the geometry is

This method works only with single-line (or single-curve).

:raises TypeError: if the geometry is not a single-line type
:raises `TypeError` if the geometry is not a single-line type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down Expand Up @@ -1892,9 +1892,9 @@ Any z or m values present in the geometry will be discarded. If the geometry is

This method works only with single-polygon (or single-curve polygon) geometry types.

:raises TypeError: if the geometry is not a single-polygon type
:raises `TypeError` if the geometry is not a single-polygon type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down Expand Up @@ -1924,9 +1924,9 @@ Any z or m values present in the geometry will be discarded.

This method works only with multi-point geometry types.

:raises TypeError: if the geometry is not a multi-point type
:raises `TypeError` if the geometry is not a multi-point type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down Expand Up @@ -1957,9 +1957,9 @@ Any z or m values present in the geometry will be discarded. If the geometry is

This method works only with multi-linestring (or multi-curve) geometry types.

:raises TypeError: if the geometry is not a multi-linestring type
:raises `TypeError` if the geometry is not a multi-linestring type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down Expand Up @@ -1990,9 +1990,9 @@ Any z or m values present in the geometry will be discarded. If the geometry is

This method works only with multi-polygon (or multi-curve polygon) geometry types.

:raises TypeError: if the geometry is not a multi-polygon type
:raises `TypeError` if the geometry is not a multi-polygon type

:raises ValueError: if the geometry is null
:raises `ValueError` if the geometry is null
%End
%MethodCode
const QgsWkbTypes::Type type = sipCpp->wkbType();
Expand Down
Expand Up @@ -71,7 +71,7 @@ Returns a geometry from within the collection.

:param n: index of geometry to return.

:raises IndexError: if no geometry with the specified index exists.
:raises `IndexError` if no geometry with the specified index exists.
%End
%MethodCode
if ( a0 < 0 || a0 >= sipCpp->numGeometries() )
Expand Down Expand Up @@ -137,7 +137,7 @@ Removes a geometry from the collection by index.

:return: ``True`` if removal was successful.

:raises IndexError: if no geometry with the specified index exists.
:raises `IndexError` if no geometry with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numGeometries();
Expand Down Expand Up @@ -263,7 +263,7 @@ Returns the geometry at the specified ``index``.
Indexes can be less than 0, in which case they correspond to geometries from the end of the collect. E.g. an index of -1
corresponds to the last geometry in the collection.

:raises IndexError: if no geometry with the specified ``index`` exists.
:raises `IndexError` if no geometry with the specified ``index`` exists.

.. versionadded:: 3.6
%End
Expand Down Expand Up @@ -291,7 +291,7 @@ Deletes the geometry at the specified ``index``.
Indexes can be less than 0, in which case they correspond to geometries from the end of the collection. E.g. an index of -1
corresponds to the last geometry in the collection.

:raises IndexError: if no geometry at the ``index`` exists
:raises `IndexError` if no geometry at the ``index`` exists

.. versionadded:: 3.6
%End
Expand Down
24 changes: 12 additions & 12 deletions python/core/auto_generated/geometry/qgslinestring.sip.in
Expand Up @@ -279,7 +279,7 @@ Returns the point at the specified index.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numPoints();
Expand Down Expand Up @@ -308,7 +308,7 @@ Returns the x-coordinate of the specified node in the line string.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numPoints();
Expand All @@ -335,7 +335,7 @@ Returns the y-coordinate of the specified node in the line string.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numPoints();
Expand Down Expand Up @@ -367,7 +367,7 @@ If the LineString does not have a z-dimension then ``nan`` will be returned.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numPoints();
Expand Down Expand Up @@ -395,7 +395,7 @@ If the LineString does not have a m-dimension then ``nan`` will be returned.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.
%End
%MethodCode
const int count = sipCpp->numPoints();
Expand All @@ -422,7 +422,7 @@ The corresponding node must already exist in line string.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.

.. seealso:: :py:func:`xAt`
%End
Expand Down Expand Up @@ -451,7 +451,7 @@ The corresponding node must already exist in line string.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.

.. seealso:: :py:func:`yAt`
%End
Expand Down Expand Up @@ -480,7 +480,7 @@ The corresponding node must already exist in line string and the line string mus
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.

.. seealso:: :py:func:`zAt`
%End
Expand Down Expand Up @@ -509,7 +509,7 @@ The corresponding node must already exist in line string and the line string mus
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.

.. seealso:: :py:func:`mAt`
%End
Expand Down Expand Up @@ -743,7 +743,7 @@ Returns the point at the specified ``index``.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified ``index`` exists.
:raises `IndexError` if no point with the specified ``index`` exists.

.. versionadded:: 3.6
%End
Expand Down Expand Up @@ -772,7 +772,7 @@ Sets the point at the specified ``index``.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified ``index`` exists.
:raises `IndexError` if no point with the specified ``index`` exists.

.. versionadded:: 3.6
%End
Expand Down Expand Up @@ -804,7 +804,7 @@ Deletes the vertex at the specified ``index``.
Indexes can be less than 0, in which case they correspond to positions from the end of the line. E.g. an index of -1
corresponds to the last point in the line.

:raises IndexError: if no point with the specified ``index`` exists.
:raises `IndexError` if no point with the specified ``index`` exists.

.. versionadded:: 3.6
%End
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/geometry/qgsmulticurve.sip.in
Expand Up @@ -28,7 +28,7 @@ Multi curve geometry collection.
%Docstring
Returns the curve with the specified ``index``.

:raises IndexError: if no curve with the specified index exists.
:raises `IndexError` if no curve with the specified index exists.

.. versionadded:: 3.16
%End
Expand Down
Expand Up @@ -33,7 +33,7 @@ Constructor for an empty multilinestring geometry.
%Docstring
Returns the line string with the specified ``index``.

:raises IndexError: if no line string with the specified index exists.
:raises `IndexError` if no line string with the specified index exists.

.. versionadded:: 3.16
%End
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/geometry/qgsmultipoint.sip.in
Expand Up @@ -31,7 +31,7 @@ Constructor for an empty multipoint geometry.
%Docstring
Returns the point with the specified ``index``.

:raises IndexError: if no point with the specified index exists.
:raises `IndexError` if no point with the specified index exists.

.. versionadded:: 3.16
%End
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/geometry/qgsmultipolygon.sip.in
Expand Up @@ -33,7 +33,7 @@ Constructor for an empty multipolygon geometry.
%Docstring
Returns the polygon with the specified ``index``.

:raises IndexError: if no polygon with the specified index exists.
:raises `IndexError` if no polygon with the specified index exists.

.. versionadded:: 3.16
%End
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/geometry/qgsmultisurface.sip.in
Expand Up @@ -33,7 +33,7 @@ Constructor for an empty multisurface geometry.
%Docstring
Returns the surface with the specified ``index``.

:raises IndexError: if no surface with the specified index exists.
:raises `IndexError` if no surface with the specified index exists.

.. versionadded:: 3.16
%End
Expand Down
Expand Up @@ -178,7 +178,7 @@ This method will not perform any statistical calculations, rather it will return
statistics which are included in the data source's metadata. Not all data sources include this information
in the metadata, and even for sources with statistical metadata only some ``statistic`` values may be available.

:raises ValueError: if no matching precalculated statistic is available for the attribute.
:raises `ValueError` if no matching precalculated statistic is available for the attribute.
%End
%MethodCode
{
Expand Down Expand Up @@ -216,7 +216,7 @@ This method will not perform any statistical calculations, rather it will return
statistics which are included in the data source's metadata. Not all data sources include this information
in the metadata, and even for sources with statistical metadata only some ``statistic`` values may be available.

:raises ValueError: if no matching precalculated statistic is available for the attribute.
:raises `ValueError` if no matching precalculated statistic is available for the attribute.
%End
%MethodCode
{
Expand Down
Expand Up @@ -701,7 +701,7 @@ The ``datasourceOptions`` and ``layerOptions`` arguments is used to pass on GDAL

This function creates a new object and the caller takes responsibility for deleting the returned object.

:raises :: py:class:`QgsProcessingException`
:raises `QgsProcessingException`
%End

QgsProcessingFeatureSource *parameterAsSource( const QVariantMap &parameters, const QString &name, QgsProcessingContext &context ) const /Factory/;
Expand Down
Expand Up @@ -1007,7 +1007,7 @@ The ``datasourceOptions`` and ``layerOptions`` arguments is used to pass on GDAL

This function creates a new object and the caller takes responsibility for deleting the returned object.

:raises :: py:class:`QgsProcessingException`
:raises `QgsProcessingException`

.. versionadded:: 3.4
%End
Expand Down
Expand Up @@ -818,7 +818,7 @@ be returned.

This method requires PROJ 8.0 or later

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on PROJ 7 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on PROJ 7 or earlier.


.. versionadded:: 3.20
Expand All @@ -832,7 +832,7 @@ Attempts to retrieve the name of the celestial body associated with the CRS (e.g

This method requires PROJ 8.1 or later

:raises :: py:class:`QgsNotSupportedException` on QGIS builds based on PROJ 8.0 or earlier.
:raises `QgsNotSupportedException` on QGIS builds based on PROJ 8.0 or earlier.


.. versionadded:: 3.20
Expand Down

0 comments on commit 4ff3f44

Please sign in to comment.