diff options
author | Eli Zaretskii <eliz@gnu.org> | 2018-11-16 10:19:22 +0200 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2018-11-16 10:19:22 +0200 |
commit | 936a8f3093f53442bb759880c8cddd5f4eb539a5 (patch) | |
tree | ef1e0eb86ae48bd97dbc7c3553f864196c0fbaad | |
parent | 99f99a1fb227ec48f5325b6ccef5815c357b4792 (diff) | |
download | emacs-936a8f3093f53442bb759880c8cddd5f4eb539a5.tar.gz |
Document Emacs 26 behavior of Dired's 'Z' on directories
* doc/emacs/dired.texi (Operating on Files): Document behavior
of 'Z' on directories.
* etc/NEWS: Belatedly announce the new behavior of Dired's 'Z'
on directory names and on .tar.gz archives.
-rw-r--r-- | doc/emacs/dired.texi | 10 | ||||
-rw-r--r-- | etc/NEWS | 10 |
2 files changed, 18 insertions, 2 deletions
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index fba9d31406e..9c408e13ae7 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi @@ -768,9 +768,15 @@ suitable guess made using the variables @code{lpr-command} and @item Z Compress the specified files (@code{dired-do-compress}). If the file appears to be a compressed file already, uncompress it instead. Each -marked file is compressed into its own archive. This uses the +marked file is compressed into its own archive; this uses the @command{gzip} program if it is available, otherwise it uses -@command{compress}. +@command{compress}. On a directory name, this command produces a +compressed @file{.tar.gz} archive containing all of the directory's +files, by running the @command{tar} command with output piped to +@command{gzip}. To allow decompression of compressed directories, +typing @kbd{Z} on a @file{.tar.gz} or @file{.tgz} archive file unpacks +all the files in the archive into a directory whose name is the +archive name with the extension removed. @findex dired-do-compress-to @kindex c @r{(Dired)} @@ -51,6 +51,16 @@ often cause crashes. Set it to nil if you really need those fonts. * Changes in Specialized Modes and Packages in Emacs 26.2 +** Dired ++++ +*** The 'Z' command on a directory name compresses all of its files. +It produces a compressed '.tar.gz' archive with all the files in the +directory and all of its subdirectories. For symmetry, 'Z' on a +'.tar.gz' or a '.tgz' archive extracts all the archived files into a +directory whose name is the archive name sans the '.tar.gz' or '.tgz' +extension. (This change was actually made in Emacs 26.1, but was not +called out in its NEWS.) + ** Ibuffer --- |