From aee1709d6c02f466b88ea0aa44928e6820f45045 Mon Sep 17 00:00:00 2001 From: Even Rouault Date: Mon, 17 May 2021 16:00:12 +0200 Subject: projsync: make it filter out files not intended for the current version * Add a PROJ_DATA.VERSION in proj.db to indicate the target PROJ-data package version * Make projsync use that information and the version_added and version_removed properties added in https://github.com/OSGeo/PROJ-data/pull/67 to filter out files that are not relevant * Add --no-version-filtering and --verbose switches --- docs/source/apps/projsync.rst | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/source/apps/projsync.rst b/docs/source/apps/projsync.rst index 247bd2e8..7722e52e 100644 --- a/docs/source/apps/projsync.rst +++ b/docs/source/apps/projsync.rst @@ -24,7 +24,8 @@ Synopsis | [--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] Description *********** @@ -108,6 +109,12 @@ The following control parameters can appear in any order: Quiet mode +.. option:: --verbose + + .. versionadded:: 8.1 + + Verbose mode (more than default) + .. option:: --dry-run Simulate the behavior of the tool without downloading resource files. @@ -116,6 +123,16 @@ The following control parameters can appear in any order: List file names, with the source_id and area_of_use properties. +.. option:: --no-version-filtering + + .. versionadded:: 8.1 + + By default, projsync only downloads files that are compatible of + the PROJ_DATA.VERSION metadata of :file:`proj.db`, taking into account the + ``version_added`` and ``version_removed`` properties of entries in :file:`files.geojson`. + When specifying this switch, all files referenced in :file:`files.geojson` + will be candidate (combined with other filters). + At least one of :option:`--list-files`, :option:`--file`, :option:`--source-id`, :option:`--area-of-use`, :option:`--bbox` or :option:`--all` must be specified. -- cgit v1.2.3