aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/man1/cct.16
-rw-r--r--man/man1/cs2cs.14
-rw-r--r--man/man1/geod.112
-rw-r--r--man/man1/gie.14
-rw-r--r--man/man1/proj.14
-rw-r--r--man/man1/projinfo.1222
-rw-r--r--man/man1/projsync.129
7 files changed, 252 insertions, 29 deletions
diff --git a/man/man1/cct.1 b/man/man1/cct.1
index 5c4b145d..f6673b2d 100644
--- a/man/man1/cct.1
+++ b/man/man1/cct.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "CCT" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "CCT" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
cct \- Coordinate Conversion and Transformation
.
@@ -56,7 +56,7 @@ 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
+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
@@ -354,7 +354,7 @@ Hence, in honour of \fIcct\fP (the geodesist) this is \fBcct\fP (the program).
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/cs2cs.1 b/man/man1/cs2cs.1
index 6b7c9704..5334ba9a 100644
--- a/man/man1/cs2cs.1
+++ b/man/man1/cs2cs.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "CS2CS" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "CS2CS" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
cs2cs \- Cartographic coordinate system filter
.
@@ -398,7 +398,7 @@ outputs
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/geod.1 b/man/man1/geod.1
index b6b261c2..1a9a8a3a 100644
--- a/man/man1/geod.1
+++ b/man/man1/geod.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "GEOD" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "GEOD" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
geod \- Geodesic computations
.
@@ -80,21 +80,19 @@ Gives a listing of all the ellipsoids that may be selected with the
.TP
.B \-lu
Gives a listing of all the units that may be selected with the \fI+units=\fP
-option.
+option. (Default units are meters.)
.UNINDENT
.INDENT 0.0
.TP
.B \-f <format>
Where \fIformat\fP is a printf format string to control the output form of the
-geographic coordinate values. The default mode is DMS for geographic
-coordinates and \fB"%.3f"\fP for distance.
+geographic coordinate values. The default mode is DMS.
.UNINDENT
.INDENT 0.0
.TP
.B \-F <format>
Where \fIformat\fP is a printf format string to control the output form of the distance
-value (\fB\-F\fP). The default mode is DMS for geographic coordinates and
-\fB"%.3f"\fP for distance.
+value. The default mode is \fB"%.3f"\fP\&.
.UNINDENT
.INDENT 0.0
.TP
@@ -249,7 +247,7 @@ C. F. F. Karney, \fI\%Algorithms for Geodesics\fP, J. Geodesy \fB87\fP(1), 43–
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/gie.1 b/man/man1/gie.1
index 5a47ec0e..3134a75a 100644
--- a/man/man1/gie.1
+++ b/man/man1/gie.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "GIE" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "GIE" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
gie \- The Geospatial Integrity Investigation Environment
.
@@ -511,7 +511,7 @@ So in honour, and hopefully also in the spirit, of Gerald Ian Evenden
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/proj.1 b/man/man1/proj.1
index 4485c3fa..29fd63b1 100644
--- a/man/man1/proj.1
+++ b/man/man1/proj.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "PROJ" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "PROJ" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
proj \- Cartographic projection filter
.
@@ -258,7 +258,7 @@ support for datum translation.
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/projinfo.1 b/man/man1/projinfo.1
index 24041bbe..d32c5d39 100644
--- a/man/man1/projinfo.1
+++ b/man/man1/projinfo.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "PROJINFO" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "PROJINFO" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
projinfo \- Geodetic object and coordinate operation queries
.
@@ -45,11 +45,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
[\-\-show\-superseded] [\-\-hide\-ballpark] [\-\-accuracy {accuracy}]
[\-\-allow\-ellipsoidal\-height\-as\-vertical\-crs]
[\-\-boundcrs\-to\-wgs84]
+[\-\-authority name]
[\-\-main\-db\-path path] [\-\-aux\-db\-path path]*
+[\-\-dump\-db\-structure]
[\-\-identify] [\-\-3d]
+[\-\-output\-id AUTH:CODE]
[\-\-c\-ify] [\-\-single\-line]
-\-\-searchpaths | \-\-remote\-data | {object_definition} |
-{object_reference} | (\-s {srs_def} \-t {srs_def})
+\-\-searchpaths | \-\-remote\-data |
+\-\-list\-crs [list\-crs\-filter] |
+\-\-dump\-db\-structure [{object_definition} | {object_reference}] |
+{object_definition} | {object_reference} | (\-s {srs_def} \-t {srs_def})
.in -2
.fi
@@ -108,7 +113,7 @@ The following control parameters can appear in any order:
.TP
.B \-o formats
formats is a comma separated combination of:
-\fBall\fP, \fBdefault\fP, \fBPROJ\fP, \fBWKT_ALL\fP, \fBWKT2:2015\fP, \fBWKT2:2019\fP, \fBWKT1:GDAL\fP, \fBWKT1:ESRI\fP, \fBPROJJSON\fP\&.
+\fBall\fP, \fBdefault\fP, \fBPROJ\fP, \fBWKT_ALL\fP, \fBWKT2:2015\fP, \fBWKT2:2019\fP, \fBWKT1:GDAL\fP, \fBWKT1:ESRI\fP, \fBPROJJSON\fP, \fBSQL\fP\&.
.sp
Except \fBall\fP and \fBdefault\fP, other formats can be preceded by \fB\-\fP to disable them.
.sp
@@ -126,6 +131,13 @@ Before PROJ 6.3.0, WKT1:GDAL was implicitly calling \-\-boundcrs\-to\-wgs84.
This is no longer the case.
.UNINDENT
.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+When SQL is specified, \fI\%\-\-output\-id\fP must be specified.
+.UNINDENT
+.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
@@ -195,7 +207,7 @@ only used for coordinate operation computation
Specify how the area of use of coordinate operations found in the database
are compared to the area of use specified explicitly with \fI\%\-\-area\fP or \fI\%\-\-bbox\fP,
or derived implicitly from the area of use of the source and target CRS.
-By default, projinfo will only keep coordinate operations whose are of use
+By default, \fBprojinfo\fP will only keep coordinate operations whose are of use
is strictly within the area of interest (\fBcontains\fP strategy).
If using the \fBintersects\fP strategy, the spatial test is relaxed, and any
coordinate operation whose area of use at least partly intersects the
@@ -263,7 +275,7 @@ only used for coordinate operation computation
.B \-\-pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}
Determine if intermediate (pivot) CRS can be used when researching coordinate
operation between 2 CRS. A typical example is the WGS84 pivot. By default,
-projinfo will consider any potential pivot if there is no direct transformation
+\fBprojinfo\fP will consider any potential pivot if there is no direct transformation
( \fBif_no_direct_transformation\fP). If using the \fBnever\fP strategy,
only direct transformations between the source and target CRS will be
used. If using the \fBalways\fP strategy, intermediate CRS will be considered
@@ -351,9 +363,20 @@ This is mostly to be used for early\-binding approaches.
.UNINDENT
.INDENT 0.0
.TP
+.B \-\-authority name
+Specify the name of the authority into which to restrict looks up for
+objects, when specifying an object by name or when coordinate operations are
+computed. The default is to allow all authorities.
+.sp
+When used with SQL output, this restricts the authorities to which intermediate
+objects can belong to (the default is EPSG and PROJ). Note that the authority
+of the \fI\%\-\-output\-id\fP option will also be implicitly added.
+.UNINDENT
+.INDENT 0.0
+.TP
.B \-\-main\-db\-path path
-Specify the name and path of the database to be used by projinfo. The
-default is proj.db in the PROJ resource directories.
+Specify the name and path of the database to be used by \fBprojinfo\fP\&.
+The default is \fBproj.db\fP in the PROJ resource directories.
.UNINDENT
.INDENT 0.0
.TP
@@ -377,6 +400,29 @@ with a likelihood of 70% to EPSG:32631
.UNINDENT
.INDENT 0.0
.TP
+.B \-\-dump\-db\-structure
+New in version 8.1.
+
+.sp
+Outputs the sequence of SQL statements to create a new empty valid auxiliary
+database. This option can be specified as the only switch of the utility.
+If also specifying a CRS object and the \fI\%\-\-output\-id\fP option, the
+definition of the object as SQL statements will be appended.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-list\-crs [list\-crs\-filter]
+New in version 8.1.
+
+.sp
+Outputs a list (authority name:code and CRS name) of the filtered CRSs from the database.
+If no filter is provided all authority names and types of non deprecated CRSs are dumped.
+list\-crs\-filter is a comma separated combination of: allow_deprecated,geodetic,geocentric,
+geographic,geographic_2d,geographic_3d,vertical,projected,compound.
+Affected by options \fI\%\-\-authority\fP, \fI\%\-\-area\fP, \fI\%\-\-bbox\fP and \fI\%\-\-spatial\-test\fP
+.UNINDENT
+.INDENT 0.0
+.TP
.B \-\-3d
New in version 6.3.
@@ -390,6 +436,28 @@ ellipsoidal height in metres, using the ellipsoid of the base geodetic CRS.
.UNINDENT
.INDENT 0.0
.TP
+.B \-\-output\-id=AUTH:NAME
+New in version 8.1.
+
+.sp
+Identifier to assign to the object (for SQL output).
+.sp
+It is strongly recommended that new objects should not be added in common
+registries, such as \fBEPSG\fP, \fBESRI\fP, \fBIAU\fP, etc.
+Users should use a custom authority name instead. If a new object should be
+added to the official EPSG registry, users are invited to follow the
+procedure explained at \fI\%https://epsg.org/dataset\-change\-requests.html\fP\&.
+.sp
+Combined with \fI\%\-\-dump\-db\-structure\fP, users can create
+auxiliary databases, instead of directly modifying the main \fBproj.db\fP database.
+See the \fI\%example how to export to an auxiliary database\fP\&.
+.sp
+Those auxiliary databases can be specified through
+\fBproj_context_set_database_path()\fP or the \fBPROJ_AUX_DB\fP
+environment variable.
+.UNINDENT
+.INDENT 0.0
+.TP
.B \-\-c\-ify
For developers only. Modify the string output of the utility so that it
is easy to put those strings in C/C++ code
@@ -604,12 +672,148 @@ Output:
.fi
.UNINDENT
.UNINDENT
+.INDENT 0.0
+.IP 4. 3
+Exporting the SQL statements to insert a new CRS in an auxiliary database.
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+# Get the SQL statements for a custom CRS
+projinfo "+proj=merc +lat_ts=5 +datum=WGS84 +type=crs +title=my_crs" \-\-output\-id HOBU:MY_CRS \-o SQL \-q > my_crs.sql
+cat my_crs.sql
+
+# Initialize an auxiliary database with the schema of the reference database
+echo ".schema" | sqlite3 /path/to/proj.db | sqlite3 aux.db
+
+# Append the content of the definition of HOBU:MY_CRS
+sqlite3 aux.db < my_crs.db
+
+# Check that everything works OK
+projinfo \-\-aux\-db\-path aux.db HOBU:MY_CRS
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+or more simply:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+# Create an auxiliary database with the definition of a custom CRS.
+projinfo "+proj=merc +lat_ts=5 +datum=WGS84 +type=crs +title=my_crs" \-\-output\-id HOBU:MY_CRS \-\-dump\-db\-structure | sqlite3 aux.db
+
+# Check that everything works OK
+projinfo \-\-aux\-db\-path aux.db HOBU:MY_CRS
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Output:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+INSERT INTO geodetic_crs VALUES(\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqunknown\(aq,\(aq\(aq,\(aqgeographic 2D\(aq,\(aqEPSG\(aq,\(aq6424\(aq,\(aqEPSG\(aq,\(aq6326\(aq,NULL,0);
+INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_GEODETIC_CRS_MY_CRS\(aq,\(aqgeodetic_crs\(aq,\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq);
+INSERT INTO conversion VALUES(\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,\(aqunknown\(aq,\(aq\(aq,\(aqEPSG\(aq,\(aq9805\(aq,\(aqMercator (variant B)\(aq,\(aqEPSG\(aq,\(aq8823\(aq,\(aqLatitude of 1st standard parallel\(aq,5,\(aqEPSG\(aq,\(aq9122\(aq,\(aqEPSG\(aq,\(aq8802\(aq,\(aqLongitude of natural origin\(aq,0,\(aqEPSG\(aq,\(aq9122\(aq,\(aqEPSG\(aq,\(aq8806\(aq,\(aqFalse easting\(aq,0,\(aqEPSG\(aq,\(aq9001\(aq,\(aqEPSG\(aq,\(aq8807\(aq,\(aqFalse northing\(aq,0,\(aqEPSG\(aq,\(aq9001\(aq,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,0);
+INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_CONVERSION_MY_CRS\(aq,\(aqconversion\(aq,\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq);
+INSERT INTO projected_crs VALUES(\(aqHOBU\(aq,\(aqMY_CRS\(aq,\(aqmy_crs\(aq,\(aq\(aq,\(aqEPSG\(aq,\(aq4400\(aq,\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,NULL,0);
+INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_PROJECTED_CRS_MY_CRS\(aq,\(aqprojected_crs\(aq,\(aqHOBU\(aq,\(aqMY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+PROJ.4 string:
++proj=merc +lat_ts=5 +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs +type=crs
+
+WKT2:2019 string:
+PROJCRS["my_crs",
+ BASEGEOGCRS["unknown",
+ ENSEMBLE["World Geodetic System 1984 ensemble",
+ MEMBER["World Geodetic System 1984 (Transit)"],
+ MEMBER["World Geodetic System 1984 (G730)"],
+ MEMBER["World Geodetic System 1984 (G873)"],
+ MEMBER["World Geodetic System 1984 (G1150)"],
+ MEMBER["World Geodetic System 1984 (G1674)"],
+ MEMBER["World Geodetic System 1984 (G1762)"],
+ ELLIPSOID["WGS 84",6378137,298.257223563,
+ LENGTHUNIT["metre",1]],
+ ENSEMBLEACCURACY[2.0]],
+ PRIMEM["Greenwich",0,
+ ANGLEUNIT["degree",0.0174532925199433]],
+ ID["HOBU","GEODETIC_CRS_MY_CRS"]],
+ CONVERSION["unknown",
+ METHOD["Mercator (variant B)",
+ ID["EPSG",9805]],
+ PARAMETER["Latitude of 1st standard parallel",5,
+ ANGLEUNIT["degree",0.0174532925199433],
+ ID["EPSG",8823]],
+ PARAMETER["Longitude of natural origin",0,
+ ANGLEUNIT["degree",0.0174532925199433],
+ ID["EPSG",8802]],
+ PARAMETER["False easting",0,
+ LENGTHUNIT["metre",1],
+ ID["EPSG",8806]],
+ PARAMETER["False northing",0,
+ LENGTHUNIT["metre",1],
+ ID["EPSG",8807]]],
+ CS[Cartesian,2],
+ AXIS["(E)",east,
+ ORDER[1],
+ LENGTHUNIT["metre",1]],
+ AXIS["(N)",north,
+ ORDER[2],
+ LENGTHUNIT["metre",1]],
+ ID["HOBU","MY_CRS"]]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.IP 5. 3
+Get the WKT representation of EPSG:25832 in the WKT1:GDAL output format and on a single line
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+projinfo \-o WKT1:GDAL \-\-single\-line EPSG:25832
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Output:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+WKT1:GDAL string:
+PROJCS["ETRS89 / UTM zone 32N",GEOGCS["ETRS89",DATUM["European_Terrestrial_Reference_System_1989",SPHEROID["GRS 1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],AUTHORITY["EPSG","6258"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4258"]],PROJECTION["Transverse_Mercator"],PARAMETER["latitude_of_origin",0],PARAMETER["central_meridian",9],PARAMETER["scale_factor",0.9996],PARAMETER["false_easting",500000],PARAMETER["false_northing",0],UNIT["metre",1,AUTHORITY["EPSG","9001"]],AXIS["Easting",EAST],AXIS["Northing",NORTH],AUTHORITY["EPSG","25832"]]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
.SH SEE ALSO
.sp
\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
+A list of known bugs can be found at \fI\%https://github.com/OSGeo/PROJ/issues\fP
where new bug reports can be submitted to.
.SH HOME PAGE
.sp
diff --git a/man/man1/projsync.1 b/man/man1/projsync.1
index 8099bee4..57141647 100644
--- a/man/man1/projsync.1
+++ b/man/man1/projsync.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "PROJSYNC" "1" "Mar 1, 2021" "8.0.0" "PROJ"
+.TH "PROJSYNC" "1" "Jul 1, 2021" "8.1.0" "PROJ"
.SH NAME
projsync \- Downloading tool of resource files
.
@@ -44,7 +44,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
[\-\-source\-id ID] [\-\-area\-of\-use NAME]
[\-\-file NAME]
[\-\-all] [\-\-exclude\-world\-coverage]
-[\-\-quiet] [\-\-dry\-run] [\-\-list\-files]
+[\-\-quiet | \-\-verbose] [\-\-dry\-run] [\-\-list\-files]
+[\-\-no\-version\-filtering]
.in -2
.fi
.sp
@@ -67,7 +68,7 @@ the resource files. Defaults to the value set in proj\-ini
.TP
.B \-\-local\-geojson\-file FILENAME
Defines the filename for the master GeoJSON files that references resources.
-Defaults to ${endpoint}/files.geojson
+Defaults to \fB${endpoint}/files.geojson\fP
.UNINDENT
.INDENT 0.0
.TP
@@ -143,6 +144,14 @@ Quiet mode
.UNINDENT
.INDENT 0.0
.TP
+.B \-\-verbose
+New in version 8.1.
+
+.sp
+Verbose mode (more than default)
+.UNINDENT
+.INDENT 0.0
+.TP
.B \-\-dry\-run
Simulate the behavior of the tool without downloading resource files.
.UNINDENT
@@ -151,6 +160,18 @@ Simulate the behavior of the tool without downloading resource files.
.B \-\-list\-files
List file names, with the source_id and area_of_use properties.
.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-version\-filtering
+New in version 8.1.
+
+.sp
+By default, projsync only downloads files that are compatible of
+the PROJ_DATA.VERSION metadata of \fBproj.db\fP, taking into account the
+\fBversion_added\fP and \fBversion_removed\fP properties of entries in \fBfiles.geojson\fP\&.
+When specifying this switch, all files referenced in \fBfiles.geojson\fP
+will be candidate (combined with other filters).
+.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.
@@ -191,7 +212,7 @@ projsync \-\-source\-id fr_ign \-\-bbox 2,49,2,49
\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
+A list of known 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
generated by cgit v1.2.3 (git 2.25.1) at 2025-12-15 16:15:10 +0000