Update man-pages from Sphinx-docs

7 files changed, 78 insertions, 32 deletions

diff --git a/man/man1/cct.1 b/man/man1/cct.1
index 7b6a31f3..ce511d3c 100644
--- a/man/man1/cct.1
+++ b/man/man1/cct.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CCT" "1" "May 24, 2018" "5.1.0" "PROJ.4"
+.TH "CCT" "1" "Sep 10, 2018" "5.2.0" "PROJ.4"
 .SH NAME
 cct \- Coordinate Conversion and Transformation
 .
@@ -51,6 +51,13 @@ Specify input columns for (up to) 4 input parameters. Defaults to 1,2,3,4.
 .UNINDENT
 .INDENT 0.0
 .TP
+.B \-d <n>
+.UNINDENT
+.sp
+New in version 5.2.0: Specify the number of decimals in the output.
+
+.INDENT 0.0
+.TP
 .B \-I
 Do the inverse transformation.
 .UNINDENT
@@ -96,7 +103,7 @@ Usage varies with operation.
 \fBcct\fP is an acronym meaning \fICoordinate Conversion and Transformation\fP\&.
 .sp
 The acronym refers to definitions given in the OGC 08\-015r2/ISO\-19111
-standard "Geographical Information \-\- Spatial Referencing by Coordinates",
+standard “Geographical Information – Spatial Referencing by Coordinates”,
 which defines two different classes of \fIcoordinate operations\fP:
 .sp
 \fICoordinate Conversions\fP, which are coordinate operations where input
@@ -203,20 +210,36 @@ cct \-t 0 \-z 0 +proj=utm +ellps=GRS80 +zone=32
 .fi
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.IP 6. 3
+Auxiliary data following the coordinate input is forward to the output
+stream:
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ echo 12 56 100 2018.0 auxiliary data | cct +proj=merc
+1335833.8895   7522963.2411      100.0000     2018.0000 auxiliary data
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SH BACKGROUND
 .sp
-\fBcct\fP also refers to Carl Christian Tscherning (1942\-\-2014),
+\fBcct\fP also refers to Carl Christian Tscherning (1942–2014),
 professor of Geodesy at the University of Copenhagen, mentor and advisor
 for a generation of Danish geodesists, colleague and collaborator for
 two generations of global geodesists, Secretary General for the
-International Association of Geodesy, IAG (1995\-\-2007), fellow of the
+International Association of Geodesy, IAG (1995–2007), fellow of the
 American Geophysical Union (1991), recipient of the IAG Levallois Medal
 (2007), the European Geosciences Union Vening Meinesz Medal (2008), and
 of numerous other honours.
 .sp
 \fIcct\fP, or Christian, as he was known to most of us, was recognized for his
 good mood, his sharp wit, his tireless work, and his great commitment to
-the development of geodesy \-\- both through his scientific contributions,
+the development of geodesy – both through his scientific contributions,
 comprising more than 250 publications, and by his mentoring and teaching
 of the next generations of geodesists.
 .sp
diff --git a/man/man1/cs2cs.1 b/man/man1/cs2cs.1
index 77fe4247..c262ddfd 100644
--- a/man/man1/cs2cs.1
+++ b/man/man1/cs2cs.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CS2CS" "1" "May 24, 2018" "5.1.0" "PROJ.4"
+.TH "CS2CS" "1" "Sep 10, 2018" "5.2.0" "PROJ.4"
 .SH NAME
 cs2cs \- Cartographic coordinate system filter
 .
@@ -59,6 +59,13 @@ ASCII input only. (# is the default value).
 .UNINDENT
 .INDENT 0.0
 .TP
+.B \-d <n>
+.UNINDENT
+.sp
+New in version 5.2.0: Specify the number of decimals in the output.
+
+.INDENT 0.0
+.TP
 .B \-e <string>
 Where \fIstring\fP is an arbitrary string to be output if an error is detected during
 data transformations. The default value is a three character string: \fB*\et*\fP\&.
@@ -203,7 +210,7 @@ The x\-y output data will appear as three lines of:
 .sp
 .nf
 .ft C
-1402285.99      5076292.42 0.000
+1402285.98  5076292.42 \-0.00
 .ft P
 .fi
 .UNINDENT
diff --git a/man/man1/geod.1 b/man/man1/geod.1
index 82aa471f..9efd7103 100644
--- a/man/man1/geod.1
+++ b/man/man1/geod.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GEOD" "1" "May 24, 2018" "5.1.0" "PROJ.4"
+.TH "GEOD" "1" "Sep 10, 2018" "5.2.0" "PROJ.4"
 .SH NAME
 geod \- Geodesic computations
 .
@@ -143,12 +143,12 @@ azimuthal data must be in decimal degrees or DMS format and
 input distance data must be in units consistent with the ellipsoid
 major axis or sphere radius units. The latitude must lie
 in the range [\-90d,90d]. Output geographic coordinates will be
-in DMS (if the \fI\%\-f\fP switch is not employed) to 0.001" with trailing,
+in DMS (if the \fI\%\-f\fP switch is not employed) to 0.001” with trailing,
 zero\-valued minute\-second fields deleted. Output distance
 data will be in the same units as the ellipsoid or sphere
 radius.
 .sp
-The Earth\(aqs ellipsoidal figure may be selected in the same manner
+The Earth’s ellipsoidal figure may be selected in the same manner
 as program \fBproj\fP by using \fI+ellps=\fP, \fI+a=\fP, \fI+es=\fP, etc.
 .sp
 \fBgeod\fP may also be used to determine intermediate points along
@@ -201,7 +201,7 @@ where the first two values are the azimuth from Boston to Portland,
 the back azimuth from Portland to Boston followed by the distance.
 .sp
 An example of forward geodesic use is to use the Boston location
-and determine Portland\(aqs location by azimuth and distance:
+and determine Portland’s location by azimuth and distance:
 .INDENT 0.0
 .INDENT 3.5
 .sp
diff --git a/man/man1/gie.1 b/man/man1/gie.1
index 42a47db3..ea63499a 100644
--- a/man/man1/gie.1
+++ b/man/man1/gie.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GIE" "1" "May 24, 2018" "5.1.0" "PROJ.4"
+.TH "GIE" "1" "Sep 10, 2018" "5.2.0" "PROJ.4"
 .SH NAME
 gie \- The Geospatial Integrity Investigation Environment
 .
@@ -209,7 +209,7 @@ Many coordinates can be expected for one \fI\%operation\fP\&. For each
 See \fI\%operation\fP for an example.
 .sp
 In addition to expecting a coordinate it is also possible to expect a
-PROJ error code in case an operation can\(aqt be created. This is useful when
+PROJ error code in case an operation can’t be created. This is useful when
 testing that errors are caught and handled correctly. Below is an example of
 that tests that the pipeline operator fails correctly when a non\-invertible
 pipeline is constructed.
@@ -267,7 +267,7 @@ units.
 Do a roundtrip test of an operation. \fI\%roundtrip\fP needs a
 \fI\%operation\fP and a \fI\%accept\fP command
 to function. The accepted coordinate is passed to the operation first in
-it\(aqs forward mode, then the output from the forward operation is passed
+it’s forward mode, then the output from the forward operation is passed
 back to the inverse operation. This procedure is done \fBn\fP times. If the
 resulting coordinate is within the set tolerance of the initial coordinate,
 the test is passed.
@@ -343,7 +343,7 @@ expect 12 55 0 0
 .UNINDENT
 .UNINDENT
 .sp
-The default direction is "forward".
+The default direction is “forward”.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -370,6 +370,15 @@ See \fBgie \-l\fP for a list of error codes that can be ignored.
 .UNINDENT
 .INDENT 0.0
 .TP
+.B require_grid <grid_name>
+Checks the availability of the grid <grid_name>. If it is not found, then
+all \fI\%accept\fP/\fI\%expect\fP pairs until the next
+\fI\%operation\fP will be skipped.
+\fI\%require_grid\fP can be repeated several times to specify several grids whose
+presence is required.
+.UNINDENT
+.INDENT 0.0
+.TP
 .B echo <text>
 Add user defined text to the output stream. See the example below.
 .INDENT 7.0
@@ -431,21 +440,21 @@ expect  0   110579.9
 .UNINDENT
 .SH BACKGROUND
 .sp
-More importantly than being an acronym for "Geospatial Integrity Investigation
-Environment", gie were also the initials, user id, and USGS email address of
-Gerald Ian Evenden (1935\-\-2016), the geospatial visionary, who, already in the
+More importantly than being an acronym for “Geospatial Integrity Investigation
+Environment”, gie were also the initials, user id, and USGS email address of
+Gerald Ian Evenden (1935–2016), the geospatial visionary, who, already in the
 1980s, started what was to become the PROJ of today.
 .sp
-Gerald\(aqs clear vision was that map projections are \fIjust special functions\fP\&.
+Gerald’s clear vision was that map projections are \fIjust special functions\fP\&.
 Some of them rather complex, most of them of two variables, but all of them
 \fIjust special functions\fP, and not particularly more special than the \fBsin()\fP,
 \fBcos()\fP, \fBtan()\fP, and \fBhypot()\fP already available in the C standard library.
 .sp
 And hence, according to Gerald, \fIthey should not be particularly much harder
-to use\fP, for a programmer, than the \fBsin()\fP\(aqs, \fBtan()\fP\(aqs and
-\fBhypot()\fP\(aqs so readily available.
+to use\fP, for a programmer, than the \fBsin()\fP’s, \fBtan()\fP’s and
+\fBhypot()\fP’s so readily available.
 .sp
-Gerald\(aqs ingenuity also showed in the implementation of the vision, where
+Gerald’s ingenuity also showed in the implementation of the vision, where
 he devised a comprehensive, yet simple, system of key\-value pairs for
 parameterising a map projection, and the highly flexible \fBPJ\fP struct, storing
 run\-time compiled versions of those key\-value pairs, hence making a map
@@ -454,15 +463,15 @@ call like \fBhypot(x,y)\fP\&.
 .sp
 While today, we may have more formally well defined metadata systems (most
 prominent the OGC WKT2 representation), nothing comes close being as easily
-readable ("human compatible") as Gerald\(aqs key\-value system. This system in
-particular, and the PROJ system in general, was Gerald\(aqs great gift to anyone
+readable (“human compatible”) as Gerald’s key\-value system. This system in
+particular, and the PROJ system in general, was Gerald’s great gift to anyone
 using and/or communicating about geodata.
 .sp
 It is only reasonable to name a program, keeping an eye on the
 integrity of the PROJ system, in honour of Gerald.
 .sp
 So in honour, and hopefully also in the spirit, of Gerald Ian Evenden
-(1935\-\-2016), this is the Geospatial Integrity Investigation Environment.
+(1935–2016), this is the Geospatial Integrity Investigation Environment.
 .SH SEE ALSO
 .sp
 \fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP
diff --git a/man/man1/proj.1 b/man/man1/proj.1
index d85271b9..b3c8f422 100644
--- a/man/man1/proj.1
+++ b/man/man1/proj.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "PROJ" "1" "May 24, 2018" "5.1.0" "PROJ.4"
+.TH "PROJ" "1" "Sep 10, 2018" "5.2.0" "PROJ.4"
 .SH NAME
 proj \- Cartographic projection filter
 .
@@ -41,7 +41,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .SH DESCRIPTION
 .sp
 \fBproj\fP and \fBinvproj\fP perform respective forward and inverse
-transformation of cartographic data to or from cartesian data with a wide
+conversion of cartographic data to or from cartesian data with a wide
 range of selectable projection functions.
 .sp
 \fBinvproj\fP may not be available on all platforms; in this case
@@ -58,6 +58,13 @@ and allows bypassing formatting operations.
 .UNINDENT
 .INDENT 0.0
 .TP
+.B \-d <n>
+.UNINDENT
+.sp
+New in version 5.2.0: Specify the number of decimals in the output.
+
+.INDENT 0.0
+.TP
 .B \-i
 Selects binary input only (see \fI\%\-b\fP).
 .UNINDENT
@@ -213,7 +220,7 @@ default directory for a file reference without an absolute path. This is
 also used for supporting files like datum shift files.
 .sp
 One or more files (processed in left to right order) specify the source of
-data to be transformed. A \fB\-\fP will specify the location of processing standard
+data to be converted. A \fB\-\fP will specify the location of processing standard
 input. If no files are specified, the input is assumed to be from stdin.
 For ASCII input data the two data values must be in the first two white space
 separated fields and when both input and output are ASCII all trailing
@@ -222,7 +229,7 @@ portions of the input line are appended to the output line.
 Input geographic data (longitude and latitude) must be in DMS format and input
 cartesian data must be in units consistent with the ellipsoid major axis or
 sphere radius units. Output geographic coordinates will be in DMS (if the
-\fB\-w\fP switch is not employed) and precise to 0.001" with trailing, zero\-valued
+\fB\-w\fP switch is not employed) and precise to 0.001” with trailing, zero\-valued
 minute\-second fields deleted.
 .SH EXAMPLE
 .sp
diff --git a/man/man3/geodesic.3 b/man/man3/geodesic.3
index 0fd85445..2e754c4f 100644
--- a/man/man3/geodesic.3
+++ b/man/man3/geodesic.3
@@ -1,6 +1,6 @@
 .\" @(#)geodesic.3
 .\"
-.TH GEODESIC 3 "2018/06/01 Rel. 5.1.0"
+.TH GEODESIC 3 "2018/09/15 Rel. 5.2.0"
 .ad b
 .hy 1
 .SH NAME
diff --git a/man/man3/pj_init.3 b/man/man3/pj_init.3
index 964c642b..ab77d42a 100644
--- a/man/man3/pj_init.3
+++ b/man/man3/pj_init.3
@@ -1,6 +1,6 @@
-.\" @(#)pj_init.3 - 5.1.0
+.\" @(#)pj_init.3 - 5.2.0
 .\"
-.TH PJ_INIT 3 "2018/06/01 Rel. 5.1.0"
+.TH PJ_INIT 3 "2018/09/5 Rel. 5.2.0"
 .ad b
 .hy 1
 .SH NAME