diff options
| author | Brad King <brad.king@kitware.com> | 2019-05-24 14:41:43 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2019-05-24 14:43:14 (GMT) |
| commit | 4ec2b999414495ae58871755307ea17f391f7910 (patch) | |
| tree | 3d69527e6968df26a444888fbf09c8c8e7e35bb6 /Help | |
| parent | 2b8e5a3ba772d6df6e56a28d8645127008636b03 (diff) | |
| parent | c8e217e0a70f8f445e2c593f44e1105c959fb9d7 (diff) | |
| download | CMake-4ec2b999414495ae58871755307ea17f391f7910.zip CMake-4ec2b999414495ae58871755307ea17f391f7910.tar.gz CMake-4ec2b999414495ae58871755307ea17f391f7910.tar.bz2 | |
Merge topic 'selective-tar-extracting-and-listing'
c8e217e0a7 cmake: tar: Allow selective extracting and listing of archives
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !3342
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/manual/cmake.1.rst | 12 | ||||
| -rw-r--r-- | Help/release/dev/cmake-e-tar-extract-specific-files.rst | 8 |
2 files changed, 17 insertions, 3 deletions
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst index df0d4c5..97c65e7 100644 --- a/Help/manual/cmake.1.rst +++ b/Help/manual/cmake.1.rst @@ -528,16 +528,22 @@ Available commands are: ``sleep <number>...`` Sleep for given number of seconds. -``tar [cxt][vf][zjJ] file.tar [<options>] [--] [<file>...]`` +``tar [cxt][vf][zjJ] file.tar [<options>] [--] [<pathname>...]`` Create or extract a tar or zip archive. Options are: ``c`` Create a new archive containing the specified files. - If used, the <file> argument is mandatory. + If used, the ``<pathname>...`` argument is mandatory. ``x`` Extract to disk from the archive. + The ``<pathname>...`` argument could be used to extract only selected files + or directories. + When extracting selected files or directories, you must provide their exact + names including the path, as printed by list (``-t``). ``t`` - List archive contents to stdout. + List archive contents. + The ``<pathname>...`` argument could be used to list only selected files + or directories. ``v`` Produce verbose output. ``z`` diff --git a/Help/release/dev/cmake-e-tar-extract-specific-files.rst b/Help/release/dev/cmake-e-tar-extract-specific-files.rst new file mode 100644 index 0000000..4ab3eab --- /dev/null +++ b/Help/release/dev/cmake-e-tar-extract-specific-files.rst @@ -0,0 +1,8 @@ +cmake-e-tar-extract-specific-files +---------------------------------- + +* The :manual:`cmake(1)` ``-E tar`` tool allow for extract (``-x``) or list + (``-t``) only specific files or directories. To select pathnames append + a space-separated list of file names or directories. + When extracting selected files or directories, you must provide their exact + pathname, as printed by list (``-t``) |