diff options
| author | Bartosz Kosiorek <gang65@poczta.onet.pl> | 2019-05-22 19:29:08 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2019-05-23 14:08:22 (GMT) |
| commit | c8e217e0a70f8f445e2c593f44e1105c959fb9d7 (patch) | |
| tree | b02a243d33320167c75705eb7f332bb419352eb4 /Help | |
| parent | f03a80aefd4073bc1502c2e486fedfdbd8addfb6 (diff) | |
| download | CMake-c8e217e0a70f8f445e2c593f44e1105c959fb9d7.zip CMake-c8e217e0a70f8f445e2c593f44e1105c959fb9d7.tar.gz CMake-c8e217e0a70f8f445e2c593f44e1105c959fb9d7.tar.bz2 | |
cmake: tar: Allow selective extracting and listing of archives
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``) |