aboutsummaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorKristian Evers <kristianevers@gmail.com>2020-02-17 20:54:15 +0100
committerKristian Evers <kristianevers@gmail.com>2020-02-17 21:03:16 +0100
commit4fe8a81ca9d8c6883485563dfaca3415ee04389c (patch)
tree25534418cef39cdb80c7e90546cc0635aa3d6b04 /man/man1
parent6f60d8e16823f1d2fa86e013d14d8971e43fa703 (diff)
downloadPROJ-4fe8a81ca9d8c6883485563dfaca3415ee04389c.tar.gz
PROJ-4fe8a81ca9d8c6883485563dfaca3415ee04389c.zip
Update man-pages from Sphinx-docs
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/cct.126
-rw-r--r--man/man1/cs2cs.125
-rw-r--r--man/man1/geod.116
-rw-r--r--man/man1/gie.132
-rw-r--r--man/man1/proj.117
-rw-r--r--man/man1/projinfo.180
-rw-r--r--man/man1/projsync.1206
7 files changed, 321 insertions, 81 deletions
diff --git a/man/man1/cct.1 b/man/man1/cct.1
index 68bbc03b..c7274fd0 100644
--- a/man/man1/cct.1
+++ b/man/man1/cct.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "CCT" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "CCT" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.SH NAME
cct \- Coordinate Conversion and Transformation
.
@@ -33,7 +33,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
-\fBcct\fP [\fB\-cIostvz\fP [args]] \fI+opt[=arg]\fP ... file ...
+\fBcct\fP [\fB\-cIostvz\fP [args]] \fI+opt[=arg]\fP … file …
.UNINDENT
.UNINDENT
.SH DESCRIPTION
@@ -103,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
@@ -112,6 +112,16 @@ cartesian coordinates) and
.sp
\fICoordinate Transformations\fP, which are coordinate operations where
input and output datums differ (e.g. change of reference frame).
+.SH USE OF REMOTE GRIDS
+.sp
+New in version 7.0.0.
+
+.sp
+If the \fBPROJ_NETWORK\fP environment variable is set to \fBON\fP,
+\fBcct\fP will attempt to use remote grids stored on CDN (Content
+Delivery Network) storage, when they are not available locally.
+.sp
+More details are available in the network section.
.SH EXAMPLES
.INDENT 0.0
.IP 1. 3
@@ -228,18 +238,18 @@ $ echo 12 56 100 2018.0 auxiliary data | cct +proj=merc
.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
@@ -252,7 +262,7 @@ so much, and meant so much to so many people.
Hence, in honour of \fIcct\fP (the geodesist) this is \fBcct\fP (the program).
.SH SEE ALSO
.sp
-\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP
+\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -263,6 +273,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Thomas Knudsen
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/cs2cs.1 b/man/man1/cs2cs.1
index d2229f96..8efd8706 100644
--- a/man/man1/cs2cs.1
+++ b/man/man1/cs2cs.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "CS2CS" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "CS2CS" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.SH NAME
cs2cs \- Cartographic coordinate system filter
.
@@ -33,14 +33,14 @@ 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 ...
+\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] [\fI+opt[=arg]\fP …] [+to \fI+opt[=arg]\fP …] file …
.UNINDENT
.UNINDENT
.sp
or
.INDENT 0.0
.INDENT 3.5
-\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] {source_crs} +to {target_crs} file ...
+\fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] {source_crs} +to {target_crs} file …
.sp
where {source_crs} or {target_crs} is a PROJ string, a WKT string or a AUTHORITY:CODE
(where AUTHORITY is the name of a CRS authority and CODE the code of a CRS
@@ -130,11 +130,6 @@ List of all distance units that can be selected with the \fI+units\fP parameter.
.UNINDENT
.INDENT 0.0
.TP
-.B \-ld
-List of datums that can be selected with the \fI+datum\fP parameter.
-.UNINDENT
-.INDENT 0.0
-.TP
.B \-r
This options reverses the order of the expected input from
longitude\-latitude or x\-y to latitude\-longitude or y\-x.
@@ -210,6 +205,16 @@ ellipsoid major axis or sphere radius units. Output geographic coordinates will
normally be in DMS format (use \fB\-f %.12f\fP for decimal degrees with 12 decimal
places), while projected (cartesian) coordinates will be in linear
(meter, feet) units.
+.SS Use of remote grids
+.sp
+New in version 7.0.0.
+
+.sp
+If the \fBPROJ_NETWORK\fP environment variable is set to \fBON\fP,
+\fBcs2cs\fP will attempt to use remote grids stored on CDN (Content
+Delivery Network) storage, when they are not available locally.
+.sp
+More details are available in the network section.
.SH EXAMPLES
.SS Using PROJ strings
.sp
@@ -272,7 +277,7 @@ outputs
.UNINDENT
.SH SEE ALSO
.sp
-\fBproj(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP
+\fBproj(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -283,6 +288,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Frank Warmerdam
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/geod.1 b/man/man1/geod.1
index 2fc909ee..a94ff24c 100644
--- a/man/man1/geod.1
+++ b/man/man1/geod.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "GEOD" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "GEOD" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.SH NAME
geod \- Geodesic computations
.
@@ -33,9 +33,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
-\fBgeod\fP \fI+ellps=<ellipse>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP ...] file ...
+\fBgeod\fP \fI+ellps=<ellipse>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP …] file …
.sp
-\fBinvgeod\fP \fI+ellps=<ellipse>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP ...] file ...
+\fBinvgeod\fP \fI+ellps=<ellipse>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP …] file …
.UNINDENT
.UNINDENT
.SH DESCRIPTION
@@ -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
@@ -246,7 +246,7 @@ C. F. F. Karney, \fI\%Algorithms for Geodesics\fP, J. Geodesy \fB87\fP(1), 43–
.UNINDENT
.SH SEE ALSO
.sp
-\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP
+\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -257,6 +257,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Charles Karney
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/gie.1 b/man/man1/gie.1
index ac23da9d..e5e6aaf9 100644
--- a/man/man1/gie.1
+++ b/man/man1/gie.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "GIE" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "GIE" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.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
@@ -440,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
@@ -463,18 +463,18 @@ 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
+\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -485,6 +485,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Thomas Knudsen
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/proj.1 b/man/man1/proj.1
index 9a32ebfd..f1c1bd16 100644
--- a/man/man1/proj.1
+++ b/man/man1/proj.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "PROJ" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "PROJ" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.SH NAME
proj \- Cartographic projection filter
.
@@ -33,9 +33,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
-\fBproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] [\fI+opt[=arg]\fP ...] file ...
+\fBproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] [\fI+opt[=arg]\fP …] file …
.sp
-\fBinvproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] [\fI+opt[=arg]\fP ...] file ...
+\fBinvproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] [\fI+opt[=arg]\fP …] file …
.UNINDENT
.UNINDENT
.SH DESCRIPTION
@@ -130,11 +130,6 @@ List of all distance units that can be selected with the \fI+units\fP parameter.
.UNINDENT
.INDENT 0.0
.TP
-.B \-ld
-List of datums that can be selected with the \fI+datum\fP parameter.
-.UNINDENT
-.INDENT 0.0
-.TP
.B \-r
This options reverses the order of the expected input from
longitude\-latitude or x\-y to latitude\-longitude or y\-x.
@@ -216,7 +211,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
@@ -260,7 +255,7 @@ between any pair of definable coordinate reference systems, including
support for datum translation.
.SH SEE ALSO
.sp
-\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP
+\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -271,6 +266,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Gerald I. Evenden
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/projinfo.1 b/man/man1/projinfo.1
index 7b0cc3fd..3dbc41a1 100644
--- a/man/man1/projinfo.1
+++ b/man/man1/projinfo.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "PROJINFO" "1" "Dec 28, 2019" "6.3.0" "PROJ"
+.TH "PROJINFO" "1" "Feb 17, 2020" "7.0.0" "PROJ"
.SH NAME
projinfo \- Geodetic object and coordinate operation queries
.
@@ -36,17 +36,18 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nf
\fBprojinfo\fP
.in +2
-[\-o formats] [\-k crs|operation|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] [\-\-show\-superseded]
-[\-\-pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}]
-[\-\-boundcrs\-to\-wgs84]
-[\-\-main\-db\-path path] [\-\-aux\-db\-path path]*
-[\-\-identify] [\-\-3d]
-[\-\-c\-ify] [\-\-single\-line]
-{object_definition} | {object_reference} | (\-s {srs_def} \-t {srs_def})
+[\-o formats] [\-k crs|operation|datum|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] [–show\-superseded]
+[–pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}]
+[–boundcrs\-to\-wgs84]
+[–main\-db\-path path] [–aux\-db\-path path]*
+[–identify] [–3d]
+[–c\-ify] [–single\-line]
+–searchpaths | –remote\-data | {object_definition} |
+{object_reference} | (\-s {srs_def} \-t {srs_def})
.in -2
.fi
@@ -59,25 +60,25 @@ a proj\-string,
.IP \(bu 2
a WKT string,
.IP \(bu 2
-an object code (like "EPSG:4326", "urn:ogc:def:crs:EPSG::4326",
-"urn:ogc:def:coordinateOperation:EPSG::1671"),
+an object code (like “EPSG:4326”, “urn:ogc:def:crs:EPSG::4326”,
+“urn:ogc:def:coordinateOperation:EPSG::1671”),
.IP \(bu 2
a OGC URN combining references for compound coordinate reference systems
-(e.g "\fI\%urn:ogc:def:crs,crs:EPSG::2393,crs:EPSG::5717\fP" or custom abbreviated
-syntax "EPSG:2393+5717"),
+(e.g “\fI\%urn:ogc:def:crs,crs:EPSG::2393,crs:EPSG::5717\fP” or custom abbreviated
+syntax “EPSG:2393+5717”),
.IP \(bu 2
a OGC URN combining references for references for projected or derived CRSs
-e.g. for Projected 3D CRS "UTM zone 31N / WGS 84 (3D)":
-"\fI\%urn:ogc:def:crs,crs:EPSG::4979,cs:PROJ::ENh,coordinateOperation:EPSG::16031\fP"
+e.g. for Projected 3D CRS “UTM zone 31N / WGS 84 (3D)”:
+“\fI\%urn:ogc:def:crs,crs:EPSG::4979,cs:PROJ::ENh,coordinateOperation:EPSG::16031\fP”
(\fIadded in 6.2\fP)
.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")
+(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.1/projjson.schema.json\fP (\fIadded in 6.2\fP)
.UNINDENT
.sp
-{object_reference} is a filename preceded by the \(aq@\(aq character. The
+{object_reference} is a filename preceded by the ‘@’ character. The
file referenced by the {object_reference} must contain a valid
{object_definition}.
.UNINDENT
@@ -113,14 +114,14 @@ WKT2_2019 was previously called WKT2_2018.
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
-Before PROJ 6.3.0, WKT1:GDAL was implicitly calling \-\-boundcrs\-to\-wgs84.
+Before PROJ 6.3.0, WKT1:GDAL was implicitly calling –boundcrs\-to\-wgs84.
This is no longer the case.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
-.B \-k crs|operation|ellipsoid
+.B \-k crs|operation|datum|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.
@@ -152,7 +153,7 @@ potentially compatible of being piped in other utilities.
.B \-\-area name_or_code
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)
+as a name (e.g “Denmark \- onshore”) or a AUTHORITY:CODE (EPSG:3237)
This option is exclusive of \fI\%\-\-bbox\fP\&.
.sp
\fBNOTE:\fP
@@ -223,11 +224,12 @@ only used for coordinate operation computation
.UNINDENT
.INDENT 0.0
.TP
-.B \-\-grid\-check none|discard_missing|sort
+.B \-\-grid\-check none|discard_missing|sort|known_available
Specify how the presence or absence of a horizontal or vertical shift grid
required for a coordinate operation affects the results returned when
researching coordinate operations between 2 CRS.
-The default strategy is \fBsort\fP: in that case, all candidate
+The default strategy is \fBsort\fP (if \fBPROJ_NETWORK\fP is not defined).
+In that case, all candidate
operations are returned, but the actual availability of the grids is used
to determine the sorting order. That is, if a coordinate operation involves
using a grid that is not available in the PROJ resource directories
@@ -237,6 +239,9 @@ The \fBnone\fP strategy completely disables the checks of presence of grids and
this returns the results as if all the grids where available.
The \fBdiscard_missing\fP strategy discards results that involve grids not
present in the PROJ resource directories.
+The \fBknown_available\fP strategy discards results that involve grids not
+present in the PROJ resource directories and that are not known of the CDN.
+This is the default strategy is \fBPROJ_NETWORK\fP is set to \fBON\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
@@ -321,7 +326,7 @@ with a likelihood of 70% to EPSG:32631
New in version 6.3.
.sp
-"Promote" the CRS(s) to their 3D version. In the context of researching
+“Promote” the CRS(s) to their 3D version. In the context of researching
available coordinate transformations, explicitly specifying this option is
not necessary, because when one of the source or target CRS has a vertical
component but not the other one, the one that has no vertical component is
@@ -340,6 +345,25 @@ is easy to put those strings in C/C++ code
Output WKT or PROJJSON strings on a single line, instead of multiple intended lines by
default.
.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-searchpaths
+New in version 7.0.
+
+.sp
+Output the directories into which PROJ resources will be looked for
+(if not using C API such as \fBproj_context_set_search_paths()\fP
+that will override them.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-remote\-data
+New in version 7.0.
+
+.sp
+Display information regarding if network is enabled, and the
+related URL.
+.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.IP 1. 3
@@ -527,7 +551,7 @@ Output:
.UNINDENT
.SH SEE ALSO
.sp
-\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBproj(1)\fP
+\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBproj(1)\fP, \fBprojsync(1)\fP
.SH BUGS
.sp
A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
@@ -538,6 +562,6 @@ where new bug reports can be submitted to.
.SH AUTHOR
Even Rouault
.SH COPYRIGHT
-1983-2019
+1983-2020
.\" Generated by docutils manpage writer.
.
diff --git a/man/man1/projsync.1 b/man/man1/projsync.1
new file mode 100644
index 00000000..1779bf2e
--- /dev/null
+++ b/man/man1/projsync.1
@@ -0,0 +1,206 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "PROJSYNC" "1" "Feb 17, 2020" "7.0.0" "PROJ"
+.SH NAME
+projsync \- Downloading tool of resource files
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.nf
+\fBprojsync\fP
+.in +2
+[–endpoint URL]
+[–local\-geojson\-file FILENAME]
+([–user\-writable\-directory] | [–system\-directory] | [–target\-dir DIRNAME])
+[–bbox west_long,south_lat,east_long,north_lat]
+[–spatial\-test contains|intersects]
+[–source\-id ID] [–area\-of\-use NAME]
+[–file NAME]
+[–all] [–exclude\-world\-coverage]
+[–quiet] [–dry\-run] [–list\-files]
+.in -2
+.fi
+.sp
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBprojsync\fP is a program that downloads remote resource files
+into a local directory. This is an alternative to downloading a proj\-data\-X.Y.Z
+archive file, or using the on\-demand networking capabilities of PROJ.
+.sp
+The following control parameters can appear in any order:
+.INDENT 0.0
+.TP
+.B \-\-endpoint URL
+Defines the URL where to download the master \fBfiles.geojson\fP file and then
+the resource files. Defaults to the value set in proj\-ini
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-local\-geojson\-file FILENAME
+Defines the filename for the master GeoJSON files that references resources.
+Defaults to ${endpoint}/files.geojson
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-user\-writable\-directory
+Specifies that resource files must be downloaded in the
+user writable directory\&. This is the default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-system\-directory
+Specifies that resource files must be downloaded in the
+${installation_prefix}/share/proj directory. The user launching projsync
+should make sure it has writing rights in that directory.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-target\-dir DIRNAME
+Directory into which resource files must be downloaded.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-bbox west_long,south_lat,east_long,north_lat
+Specify an area of interest to restrict the resources to download.
+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 \-\-spatial\-test contains|intersects
+Specify how the extent of the resource files
+are compared to the area of use specified explicitly with \fI\%\-\-bbox\fP\&.
+By default, any resource files whose extent intersects the value specified
+by \fI\%\-\-bbox\fP will be selected.
+If using the \fBcontains\fP strategy, only resource files whose extent is
+contained in the value specified by \fI\%\-\-bbox\fP will be selected.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-source\-id ID
+Restrict resource files to be downloaded to those whose source_id property
+contains the ID value. Specifying \fB?\fP as ID will list all possible values.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-area\-of\-use NAME
+Restrict resource files to be downloaded to those whose area_of_use property
+contains the NAME value. Specifying \fB?\fP as NAME will list all possible values.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-file NAME
+Restrict resource files to be downloaded to those whose name property
+contains the NAME value. Specifying \fB?\fP as NAME will list all possible values.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-all
+Ask to download all files.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-exclude\-world\-coverage
+Exclude files which have world coverage.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-q / \-\-quiet
+Quiet mode
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-dry\-run
+Simulate the behaviour of the tool without downloading resource files.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-list\-files
+List file names, with the source_id and area_of_use properties.
+.UNINDENT
+.sp
+At least one of \fI\%\-\-list\-files\fP, \fI\%\-\-file\fP, \fI\%\-\-source\-id\fP,
+\fI\%\-\-area\-of\-use\fP, \fI\%\-\-bbox\fP or \fI\%\-\-all\fP must be specified.
+.sp
+Options \fI\%\-\-file\fP, \fI\%\-\-source\-id\fP, \fI\%\-\-area\-of\-use\fP and
+\fI\%\-\-bbox\fP are combined with a AND logic.
+.SH EXAMPLES
+.INDENT 0.0
+.IP 1. 3
+Download all resource files
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+projsync \-\-all
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.IP 2. 3
+Download resource files covering specified point and attributing to an agency
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+projsync \-\-source\-id fr_ign \-\-bbox 2,49,2,49
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBproj(1)\fP, \fBprojinfo(1)\fP
+.SH BUGS
+.sp
+A list of know bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
+where new bug reports can be submitted to.
+Bugs specific to resource files should be submitted to
+\fI\%https://github.com/OSGeo/PROJ\-data/issues\fP
+.SH HOME PAGE
+.sp
+\fI\%https://proj.org/\fP
+.SH AUTHOR
+Even Rouault
+.SH COPYRIGHT
+1983-2020
+.\" Generated by docutils manpage writer.
+.