Skip to content
Permalink
Browse files

Add version of deprecation

  • Loading branch information
DelazJ authored and nyalldawson committed Mar 4, 2020
1 parent 1eae00e commit 7ca97f38d2b70a2cb53004f5d2f9358f2454c3eb
@@ -233,7 +233,7 @@ A CRS object using a PostGIS SRID, an EPSG code or an internal QGIS CRS ID.
:param type: One of the types described in CrsType

.. deprecated::
We encourage you to use EPSG codes or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
QGIS 3.10 We encourage you to use EPSG codes or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
%End

QgsCoordinateReferenceSystem( const QgsCoordinateReferenceSystem &srs );
@@ -289,7 +289,7 @@ Creates a CRS from a proj style formatted string.
.. seealso:: :py:func:`createFromProj`

.. deprecated::
Use fromProj() instead.
QGIS 3.10 Use fromProj() instead.
%End

static QgsCoordinateReferenceSystem fromProj( const QString &proj );
@@ -342,7 +342,7 @@ Sets this CRS by lookup of the given ID in the CRS database.
:return: ``True`` on success else ``False``

.. deprecated::
We encourage you to use EPSG code or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
QGIS 3.10 We encourage you to use EPSG code or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
%End


@@ -373,7 +373,7 @@ Sets this CRS by lookup of the given PostGIS SRID in the CRS database.
:return: ``True`` on success else ``False``

.. deprecated::
Use alternative methods for SRS construction instead -- this method was specifically created for use by the postgres provider alone, and using it elsewhere will lead to subtle bugs.
QGIS 3.10 Use alternative methods for SRS construction instead -- this method was specifically created for use by the postgres provider alone, and using it elsewhere will lead to subtle bugs.
%End

bool createFromWkt( const QString &wkt );
@@ -453,7 +453,7 @@ We try to match the Proj string to internal QGIS CRS ID using the following logi
.. seealso:: :py:func:`fromProj`

.. deprecated::
Use createFromProj() instead
QGIS 3.10 Use createFromProj() instead
%End

bool createFromProj( const QString &projString );
@@ -548,7 +548,7 @@ This is required for proper shapefile CRS import when using gdal>= 1.9.
For more details refer to OGRSpatialReference.morphFromESRI() .

.. deprecated::
Not used on builds based on Proj version 6 or later
QGIS 3.10 Not used on builds based on Proj version 6 or later
%End

bool isValid() const;
@@ -586,7 +586,7 @@ pieces of information about CRS.
:return: long the SrsId of the matched CRS, zero if no match was found

.. deprecated::
Not used in Proj >= 6 based builds
QGIS 3.10 Not used in Proj >= 6 based builds
%End

bool operator==( const QgsCoordinateReferenceSystem &srs ) const;
@@ -751,7 +751,7 @@ overridden with these.
.. seealso:: :py:func:`toWkt`

.. deprecated::
use toProj() instead.
QGIS 3.10 Use toProj() instead.
%End

QString toProj() const;
@@ -860,7 +860,7 @@ Returns a list of recently used projections
:return: list of srsid for recently used projections

.. deprecated::
use recentCoordinateReferenceSystems() instead.
QGIS 3.10 Use recentCoordinateReferenceSystems() instead.
%End

static QList< QgsCoordinateReferenceSystem > recentCoordinateReferenceSystems();
@@ -265,7 +265,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* and proj strings are a lossy format.
* \param id The ID valid for the chosen CRS ID type
* \param type One of the types described in CrsType
* \deprecated We encourage you to use EPSG codes or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
* \deprecated QGIS 3.10 We encourage you to use EPSG codes or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
*/
Q_DECL_DEPRECATED explicit QgsCoordinateReferenceSystem( long id, CrsType type = PostgisCrsId ) SIP_DEPRECATED;

@@ -313,7 +313,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* Creates a CRS from a proj style formatted string.
* \returns matching CRS, or an invalid CRS if string could not be matched
* \see createFromProj()
* \deprecated Use fromProj() instead.
* \deprecated QGIS 3.10 Use fromProj() instead.
*/
Q_DECL_DEPRECATED static QgsCoordinateReferenceSystem fromProj4( const QString &proj4 ) SIP_DEPRECATED;

@@ -352,7 +352,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
/**
* Sets this CRS by lookup of the given ID in the CRS database.
* \returns TRUE on success else FALSE
* \deprecated We encourage you to use EPSG code or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
* \deprecated QGIS 3.10 We encourage you to use EPSG code or WKT to describe CRSes in your code wherever possible. Internal QGIS CRS IDs are not guaranteed to be permanent / involatile, and Proj strings are a lossy format.
*/
Q_DECL_DEPRECATED bool createFromId( long id, CrsType type = PostgisCrsId ) SIP_DEPRECATED;

@@ -377,7 +377,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* \param srid The PostGIS SRID for the desired spatial reference system.
* \returns TRUE on success else FALSE
*
* \deprecated Use alternative methods for SRS construction instead -- this method was specifically created for use by the postgres provider alone, and using it elsewhere will lead to subtle bugs.
* \deprecated QGIS 3.10 Use alternative methods for SRS construction instead -- this method was specifically created for use by the postgres provider alone, and using it elsewhere will lead to subtle bugs.
*/
Q_DECL_DEPRECATED bool createFromSrid( long srid ) SIP_DEPRECATED;

@@ -430,7 +430,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* \note Some members may be left blank if no match can be found in CRS database.
* \note This method uses an internal cache. Call invalidateCache() to clear the cache.
* \see fromProj()
* \deprecated Use createFromProj() instead
* \deprecated QGIS 3.10 Use createFromProj() instead
*/
Q_DECL_DEPRECATED bool createFromProj4( const QString &projString ) SIP_DEPRECATED;

@@ -500,7 +500,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* \note This function sets CPL config option GDAL_FIX_ESRI_WKT to a proper value,
* unless it has been set by the user through the commandline or an environment variable.
* For more details refer to OGRSpatialReference::morphFromESRI() .
* \deprecated Not used on builds based on Proj version 6 or later
* \deprecated QGIS 3.10 Not used on builds based on Proj version 6 or later
*/
Q_DECL_DEPRECATED static void setupESRIWktFix() SIP_DEPRECATED;

@@ -528,7 +528,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* pieces of information about CRS.
* \note The ellipsoid and projection acronyms must be set as well as the proj string!
* \returns long the SrsId of the matched CRS, zero if no match was found
* \deprecated Not used in Proj >= 6 based builds
* \deprecated QGIS 3.10 Not used in Proj >= 6 based builds
*/
Q_DECL_DEPRECATED long findMatchingProj() SIP_DEPRECATED;

@@ -691,7 +691,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
* \warning Not all CRS definitions can be represented by Proj strings. An empty
* string will be returned if the CRS could not be represented by a Proj string.
* \see toWkt()
* \deprecated use toProj() instead.
* \deprecated QGIS 3.10 Use toProj() instead.
*/
Q_DECL_DEPRECATED QString toProj4() const SIP_DEPRECATED;

@@ -799,7 +799,7 @@ class CORE_EXPORT QgsCoordinateReferenceSystem
/**
* Returns a list of recently used projections
* \returns list of srsid for recently used projections
* \deprecated use recentCoordinateReferenceSystems() instead.
* \deprecated QGIS 3.10 Use recentCoordinateReferenceSystems() instead.
*/
Q_DECL_DEPRECATED static QStringList recentProjections() SIP_DEPRECATED;

0 comments on commit 7ca97f3

Please sign in to comment.
You can’t perform that action at this time.