Update man-pages from Sphinx-docs

7 files changed, 206 insertions, 24 deletions

diff --git a/man/man1/cct.1 b/man/man1/cct.1
index efb03def..5c4b145d 100644
--- a/man/man1/cct.1
+++ b/man/man1/cct.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CCT" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "CCT" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 cct \- Coordinate Conversion and Transformation
 .
@@ -36,6 +36,64 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 \fBcct\fP [\fB\-cIostvz\fP [args]] \fI+opt[=arg]\fP ... file ...
 .UNINDENT
 .UNINDENT
+.sp
+or
+.INDENT 0.0
+.INDENT 3.5
+\fBcct\fP [\fB\-cIostvz\fP [args]] {object_definition} file ...
+.UNINDENT
+.UNINDENT
+.sp
+Where {object_definition}\ is one of the possibilities accepted
+by \fBproj_create()\fP, provided it expresses a coordinate operation
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+a proj\-string,
+.IP \(bu 2
+a WKT string,
+.IP \(bu 2
+an object code (like "EPSG:1671" "urn:ogc:def:coordinateOperation:EPSG::1671"),
+.IP \(bu 2
+an object name. e.g "ITRF2014 to ETRF2014 (1)". In that case as
+uniqueness is not guaranteed, heuristics are applied to determine the appropriate best match.
+.IP \(bu 2
+a OGC URN combining references for concatenated operations
+(e.g. "\fI\%urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618\fP")
+.IP \(bu 2
+a PROJJSON string. The jsonschema is at \fI\%https://proj.org/schemas/v0.2/projjson.schema.json\fP
+.UNINDENT
+.sp
+New in version 8.0.0.
+
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+Before version 8.0.0 only proj\-strings could be used to instantiate
+operations in \fBcct\fP\&.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+or
+.INDENT 0.0
+.INDENT 3.5
+\fBcct\fP [\fB\-cIostvz\fP [args]] {object_reference} file ...
+.UNINDENT
+.UNINDENT
+.sp
+where {object_reference} is a filename preceded by the \(aq@\(aq character.  The
+file referenced by the {object_reference} must contain a valid
+{object_definition}.
+.INDENT 0.0
+.INDENT 3.5
+New in version 8.0.0.
+
+.UNINDENT
+.UNINDENT
 .SH DESCRIPTION
 .sp
 \fBcct\fP is a 4D equivalent to the \fBproj\fP projection program,
@@ -237,6 +295,36 @@ $ echo 12 56 100 2018.0 auxiliary data | cct +proj=merc
 .fi
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.IP 7. 3
+Coordinate operation referenced through its code
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ echo 3541657.3778 948984.2343 5201383.5231 2020.5 | cct EPSG:8366
+3541657.9112    948983.7503  5201383.2482     2020.5000
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.IP 8. 3
+Coordinate operation referenced through its name
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ echo 3541657.3778 948984.2343 5201383.5231 2020.5 | cct "ITRF2014 to ETRF2014 (1)"
+3541657.9112    948983.7503  5201383.2482     2020.5000
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SH BACKGROUND
 .sp
 \fBcct\fP also refers to Carl Christian Tscherning (1942\-\-2014),
@@ -274,6 +362,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Thomas Knudsen
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/cs2cs.1 b/man/man1/cs2cs.1
index d4d65a00..6b7c9704 100644
--- a/man/man1/cs2cs.1
+++ b/man/man1/cs2cs.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CS2CS" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "CS2CS" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 cs2cs \- Cartographic coordinate system filter
 .
@@ -33,14 +33,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .SH SYNOPSIS
 .INDENT 0.0
 .INDENT 3.5
-\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] [\fI+opt[=arg]\fP ...] [+to \fI+opt[=arg]\fP ...] file ...
-.UNINDENT
-.UNINDENT
+.nf
+\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]]
+.in +2
+[[\-\-area <name_or_code>] | [\-\-bbox <west_long,south_lat,east_long,north_lat>]]
+[\-\-authority <name>] [\-\-no\-ballpark] [\-\-accuracy <accuracy>]
+([\fI+opt[=arg]\fP ...] [+to \fI+opt[=arg]\fP ...] | {source_crs} {target_crs})
+file ...
+.in -2
+.fi
 .sp
-or
-.INDENT 0.0
-.INDENT 3.5
-\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] {source_crs} {target_crs} file ...
 .sp
 where {source_crs} or {target_crs} is one of the possibilities accepted
 by \fBproj_create()\fP, provided it expresses a CRS
@@ -198,6 +200,66 @@ with leading zeroes.
 Causes a listing of cartographic control parameters tested for and used by
 the program to be printed prior to input data.
 .UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-area <name_or_code>
+New in version 8.0.0.
+
+.sp
+Specify an area of interest to restrict the results when researching
+coordinate operations between 2 CRS. The area of interest can be specified either
+as a name (e.g "Denmark \- onshore") or a AUTHORITY:CODE (EPSG:3237)
+.sp
+This option is mutually exclusive with \fI\%\-\-bbox\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-bbox <west_long,south_lat,east_long,north_lat>
+New in version 8.0.0.
+
+.sp
+Specify an area of interest to restrict the results when researching
+coordinate operations between 2 CRS. The area of interest is specified as a
+bounding box with geographic coordinates, expressed in degrees in a
+unspecified geographic CRS.
+\fIwest_long\fP and \fIeast_long\fP should be in the [\-180,180] range, and
+\fIsouth_lat\fP and \fInorth_lat\fP in the [\-90,90]. \fIwest_long\fP is generally lower than
+\fIeast_long\fP, except in the case where the area of interest crosses the antimeridian.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-ballpark
+New in version 8.0.0.
+
+.sp
+Disallow any coordinate operation that is, or contains, a
+Ballpark transformation
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-accuracy <accuracy>
+New in version 8.0.0.
+
+.sp
+Sets the minimum desired accuracy for candidate coordinate operations.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-authority <name>
+New in version 8.0.0.
+
+.sp
+This option can be used to restrict the authority of coordinate operations
+looked up in the database. When not specified, coordinate
+operations from any authority will be searched, with the restrictions set
+in the \fBauthority_to_authority_preference\fP database table related to the authority
+of the source/target CRS themselves.
+If authority is set to \fBany\fP, then coordinate operations from any authority will be searched
+If authority is a non\-empty string different of \fBany\fP, then coordinate operations
+will be searched only in that authority namespace (e.g \fBEPSG\fP).
+.sp
+This option is mutually exclusive with \fI\%\-\-bbox\fP\&.
+.UNINDENT
 .sp
 The \fI+opt\fP run\-line arguments are associated with cartographic
 parameters.
@@ -344,6 +406,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Frank Warmerdam
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/geod.1 b/man/man1/geod.1
index 828919a8..b6b261c2 100644
--- a/man/man1/geod.1
+++ b/man/man1/geod.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GEOD" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "GEOD" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 geod \- Geodesic computations
 .
@@ -257,6 +257,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Charles Karney
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/gie.1 b/man/man1/gie.1
index 2b5e4fa3..5a47ec0e 100644
--- a/man/man1/gie.1
+++ b/man/man1/gie.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GIE" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "GIE" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 gie \- The Geospatial Integrity Investigation Environment
 .
@@ -519,6 +519,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Thomas Knudsen
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/proj.1 b/man/man1/proj.1
index bb0a1917..4485c3fa 100644
--- a/man/man1/proj.1
+++ b/man/man1/proj.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "PROJ" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "PROJ" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 proj \- Cartographic projection filter
 .
@@ -266,6 +266,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Gerald I. Evenden
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/projinfo.1 b/man/man1/projinfo.1
index 8eca3ad6..d9736b38 100644
--- a/man/man1/projinfo.1
+++ b/man/man1/projinfo.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "PROJINFO" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "PROJINFO" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 projinfo \- Geodetic object and coordinate operation queries
 .
@@ -36,13 +36,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .nf
 \fBprojinfo\fP
 .in +2
-[\-o formats] [\-k crs|operation|datum|ellipsoid] [\-\-summary] [\-q]
+[\-o formats] [\-k crs|operation|datum|ensemble|ellipsoid] [\-\-summary] [\-q]
 [[\-\-area name_or_code] | [\-\-bbox west_long,south_lat,east_long,north_lat]]
 [\-\-spatial\-test contains|intersects]
 [\-\-crs\-extent\-use none|both|intersection|smallest]
 [\-\-grid\-check none|discard_missing|sort|known_available]
 [\-\-pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}]
-[\-\-show\-superseded] [\-\-hide\-ballpark]
+[\-\-show\-superseded] [\-\-hide\-ballpark] [\-\-accuracy {accuracy}]
+[\-\-allow\-ellipsoidal\-height\-as\-vertical\-crs]
 [\-\-boundcrs\-to\-wgs84]
 [\-\-main\-db\-path path] [\-\-aux\-db\-path path]*
 [\-\-identify] [\-\-3d]
@@ -128,7 +129,7 @@ This is no longer the case.
 .UNINDENT
 .INDENT 0.0
 .TP
-.B \-k crs|operation|datum|ellipsoid
+.B \-k crs|operation|datum|ensemble|ellipsoid
 When used to query a single object with a AUTHORITY:CODE, determines the (k)ind of the object
 in case there are CRS, coordinate operations or ellipsoids with the same CODE.
 The default is crs.
@@ -311,6 +312,37 @@ only used for coordinate operation computation
 .UNINDENT
 .INDENT 0.0
 .TP
+.B \-\-accuracy {accuracy}
+New in version 8.0.
+
+.sp
+Sets the minimum desired accuracy for returned coordinate operations.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+only used for coordinate operation computation
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-allow\-ellipsoidal\-height\-as\-vertical\-crs
+New in version 8.0.
+
+.sp
+Allow to export a geographic or projected 3D CRS as a compound CRS whose
+vertical CRS represents the ellipsoidal height.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+only used for CRS, and with WKT1:GDAL output format
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
 .B \-\-boundcrs\-to\-wgs84
 When specified, this option researches a coordinate operation from the
 base geographic CRS of the single CRS, source or target CRS to the WGS84
@@ -585,6 +617,6 @@ where new bug reports can be submitted to.
 .SH AUTHOR
 Even Rouault
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .
diff --git a/man/man1/projsync.1 b/man/man1/projsync.1
index 9e3fbb9b..8099bee4 100644
--- a/man/man1/projsync.1
+++ b/man/man1/projsync.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "PROJSYNC" "1" "Nov 01, 2020" "7.2.0" "PROJ"
+.TH "PROJSYNC" "1" "Mar 1, 2021" "8.0.0" "PROJ"
 .SH NAME
 projsync \- Downloading tool of resource files
 .
@@ -201,6 +201,6 @@ Bugs specific to resource files should be submitted to
 .SH AUTHOR
 Even Rouault
 .SH COPYRIGHT
-1983-2020
+1983-2021
 .\" Generated by docutils manpage writer.
 .