From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 22 Nov 2018 19:05:14 +0000 (+0200)
Subject: Improve documentation of 'dired-do-compress'
X-Git-Tag: emacs-26.1.91~94
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=477414ac38399a63fd69f3b2457f5716a02b3eae;p=emacs.git

Improve documentation of 'dired-do-compress'

* lisp/dired-aux.el (dired-do-compress): Describe in the doc
string the effect on directories and on compressed archive.
(Bug#33450)
---

diff --git a/lisp/dired-aux.el b/lisp/dired-aux.el
index eaf5f257012..2800bbe9021 100644
--- a/lisp/dired-aux.el
+++ b/lisp/dired-aux.el
@@ -1225,7 +1225,12 @@ return t; if SYM is q or ESC, return nil."
 
 ;;;###autoload
 (defun dired-do-compress (&optional arg)
-  "Compress or uncompress marked (or next ARG) files."
+  "Compress or uncompress marked (or next ARG) files.
+If invoked on a directory, compress all of the files in
+the directory and all of its subdirectories, recursively,
+into a .tar.gz archive.
+If invoked on a .tar.gz or a .tgz or a .zip or a .7z archive,
+uncompress and unpack all the files in the archive."
   (interactive "P")
   (dired-map-over-marks-check #'dired-compress arg 'compress t))