[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-26 936a8f3 2/2: Document Emacs 26 behavior of Dired'
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-26 936a8f3 2/2: Document Emacs 26 behavior of Dired's 'Z' on directories |
Date: |
Fri, 16 Nov 2018 03:21:07 -0500 (EST) |
branch: emacs-26
commit 936a8f3093f53442bb759880c8cddd5f4eb539a5
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
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.
---
doc/emacs/dired.texi | 10 ++++++++--
etc/NEWS | 10 ++++++++++
2 files changed, 18 insertions(+), 2 deletions(-)
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index fba9d31..9c408e1 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
address@hidden
address@hidden 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
address@hidden 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)}
diff --git a/etc/NEWS b/etc/NEWS
index 6dba2a9..4197317 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -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
---