summaryrefslogtreecommitdiff
path: root/man/dired.texi
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>2005-04-26 10:47:03 +0000
committerRichard M. Stallman <rms@gnu.org>2005-04-26 10:47:03 +0000
commitea3b47e34941c76013f38d1d5e20a3a98bdab885 (patch)
tree157d681ac160f80aa20f4d16919560123a4a15b1 /man/dired.texi
parent77d2cdef5d11dd8d9e8aadc4ef6a75659db84e2b (diff)
downloademacs-ea3b47e34941c76013f38d1d5e20a3a98bdab885.tar.gz
(Misc Dired Features): Document dired-compare-directories.
Diffstat (limited to 'man/dired.texi')
-rw-r--r--man/dired.texi26
1 files changed, 26 insertions, 0 deletions
diff --git a/man/dired.texi b/man/dired.texi
index dfd809c7607..f2699cfde07 100644
--- a/man/dired.texi
+++ b/man/dired.texi
@@ -1161,6 +1161,32 @@ if in a subdirectory.) As a special case, if point is on a directory
headerline, @kbd{w} gives you the absolute name of that directory.
Any prefix argument or marked files are ignored in this case.
+@findex dired-compare-directories
+ The command @kbd{M-x dired-compare-directories} is used to compare
+the current Dired buffer with another directory. It marks all the files
+that are ``different'' between the two directories. It puts these marks
+in all Dired buffers where these files are listed, which of course includes
+the current buffer.
+
+ The default comparison method (used if you type @key{RET} at the
+prompt) is to compare just the file names---each file name that does
+not appear in the other directory is ``different''. You can specify
+more stringent comparisons by entering a Lisp expression, which can
+refer to the variables @code{size1} and @code{size2}, the respective
+file sizes; @code{mtime1} and @code{mtime2}, the last modification
+times in seconds, as floating point numers; and @code{fa1} and
+@code{fa2}, the respective file attribute lists (as returned by the
+function @code{file-attributes}). This expression is evaluated for
+each pair of like-named files, and if the expression's value is
+non-@code{nil}, those files are considered ``different''.
+
+ For instance, @code{M-x dired-compare-directories @key{RET} (>
+mtime1 mtime2) @key{RET}} marks files newer in this directory than in
+the other, and marks files older in the other directory than in this
+one. It also marks files with no counterpart, in both directories, as
+always.
+
+@cindex drag and drop, Dired
On the X window system, Emacs supports the ``drag and drop''
protocol. You can drag a file object from another program, and drop
it onto a Dired buffer; this either moves, copies, or creates a link