[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] feature/gnus-select 19ed176 149/218: Improvements in dired
From: |
Andrew G Cohen |
Subject: |
[Emacs-diffs] feature/gnus-select 19ed176 149/218: Improvements in dired.texi |
Date: |
Fri, 14 Dec 2018 03:35:19 -0500 (EST) |
branch: feature/gnus-select
commit 19ed17602ea2deebec502b40003ace4bd295e7bd
Author: Eli Zaretskii <address@hidden>
Commit: Andrew G Cohen <address@hidden>
Improvements in dired.texi
* doc/emacs/dired.texi (Dired): Mention that Dired works with
remote directories.
(Dired Enter): ls-lisp is used on some remote systems as well.
(Dired Navigation): Mention and index the command names.
(Dired Deletion): Document the 'always' value of
dired-recursive-deletes. Mention the alternative deletion method.
(Marks vs Flags): Fix spelling of Auto-Revert mode. Document what
marking does on a subdirectory header line.
(Operating on Files): Document that 'Z' uses gzip or compress.
(Comparison in Dired): Mention ediff-files.
(Misc Dired Features): Fix a typo. Suggested by Michael Albinus
<address@hidden> in address@hidden
---
doc/emacs/dired.texi | 48 ++++++++++++++++++++++++++++++++----------------
1 file changed, 32 insertions(+), 16 deletions(-)
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index cbf4194..fbb3030 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -12,7 +12,8 @@
Dired makes an Emacs buffer containing a listing of a directory, and
optionally some of its subdirectories as well. You can use the normal
Emacs commands to move around in this buffer, and special Dired
-commands to operate on the listed files.
+commands to operate on the listed files. Dired works with both local
+and remote directories.
The Dired buffer is normally read-only, and inserting text in it is
not allowed (however, the Wdired mode allows that, @pxref{Wdired}).
@@ -109,8 +110,9 @@ default) means to perform the check; any other
address@hidden value
means to use the @samp{--dired} option; and @code{nil} means not to
use the @samp{--dired} option.
- On MS-Windows and MS-DOS systems, Emacs emulates @command{ls}.
address@hidden in Lisp}, for options and peculiarities of this emulation.
+ On MS-Windows and MS-DOS systems, and also on some remote systems,
+Emacs emulates @command{ls}. @xref{ls in Lisp}, for options and
+peculiarities of this emulation.
@findex dired-other-window
@kindex C-x 4 d
@@ -131,10 +133,13 @@ deletes its window if the window was created just for
that buffer.
@kindex C-n @r{(Dired)}
@kindex C-p @r{(Dired)}
address@hidden dired-next-line
address@hidden dired-previous-line
All the usual Emacs cursor motion commands are available in Dired
-buffers. The keys @kbd{C-n} and @kbd{C-p} are redefined to put the
-cursor at the beginning of the file name on the line, rather than at
-the beginning of the line.
+buffers. The keys @kbd{C-n} and @kbd{C-p} are redefined to run
address@hidden and @code{dired-previous-line}, respectively,
+and they put the cursor at the beginning of the file name on the line,
+rather than at the beginning of the line.
@kindex SPC @r{(Dired)}
For extra convenience, @key{SPC} and @kbd{n} in Dired are equivalent
@@ -235,10 +240,11 @@ the buffer, and no files actually deleted.
You can delete empty directories just like other files, but normally
Dired cannot delete directories that are nonempty. If the variable
@code{dired-recursive-deletes} is address@hidden, then Dired can
-delete nonempty directories including all their contents. That can
-be somewhat risky.
-Even if you have set @code{dired-recursive-deletes} to @code{nil},
-you might want sometimes to delete recursively directories
+delete nonempty directories including all their contents. That can be
+somewhat risky. If the value of the variable is @code{always}, Dired
+will delete nonempty directories recursively, which is even more
+risky. Even if you have set @code{dired-recursive-deletes} to
address@hidden, you might want sometimes to delete recursively directories
without being asked for confirmation for all of them. This is handy
when you have marked many directories for deletion and you are very
sure that all of them can safely be deleted. For every nonempty
@@ -252,6 +258,9 @@ questions.
directories into the operating system's Trash, instead of deleting
them outright. @xref{Misc File Ops}.
+ An alternative way of deleting files is to mark them with @kbd{m}
+and delete with @kbd{D}, see @ref{Operating on Files}.
+
@node Flagging Many Files
@section Flagging Many Files at Once
@cindex flagging many files for deletion (in Dired)
@@ -420,7 +429,9 @@ Mark the current file with @samp{*} (@code{dired-mark}).
If the
region is active, mark all files in the region instead; otherwise, if
a numeric argument @var{n} is supplied, mark the next @var{n} files
instead, starting with the current file (if @var{n} is negative, mark
-the previous @address@hidden files).
+the previous @address@hidden files). If invoked on a subdirectory
+header line (@pxref{Subdirectories in Dired}), this command marks all
+the files in that subdirectory.
@item * *
@kindex * * @r{(Dired)}
@@ -578,10 +589,10 @@ command will look in the buffer without revisiting the
file, so the results
might be inconsistent with the file on disk if its contents have changed
since it was last visited. If you don't want this, you may wish to
revert the files you have visited in your buffers, or to turn on
address@hidden mode in those buffers, before invoking this
-command. @xref{Reverting}. If you prefer that this command should always
+Auto-Revert mode in those buffers, before invoking this command.
address@hidden If you prefer that this command should always
revisit the file, without you having to revert the file or enable
address@hidden mode, you might want to set
+Auto-Revert mode, you might want to set
@code{dired-always-read-filesystem} to address@hidden
@item C-/
@@ -766,7 +777,9 @@ 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.
+marked file is compressed into its own archive. This uses the
address@hidden program if it is available, otherwise it uses
address@hidden
@findex dired-do-compress-to
@kindex c @r{(Dired)}
@@ -1048,6 +1061,9 @@ minibuffer is the file at the mark (i.e., the ordinary
Emacs mark,
not a Dired mark; @pxref{Setting Mark}). Otherwise, if the file at
point has a backup file (@pxref{Backup}), that is the default.
+ You could also compare files using @code{ediff-files}, see
address@hidden Entry Points,,, ediff, Ediff User's Manual}.
+
@node Subdirectories in Dired
@section Subdirectories in Dired
@cindex subdirectories in Dired
@@ -1476,7 +1492,7 @@ space.
each marked file. With just @kbd{C-u} as the prefix argument, it uses
file names relative to the Dired buffer's default directory. (This
can still contain slashes if in a subdirectory.) As a special case,
-if point is on a directory headerline, @kbd{w} gives you the absolute
+if point is on a directory header line, @kbd{w} gives you the absolute
name of that directory. Any prefix argument or marked files are
ignored in this case.
- [Emacs-diffs] feature/gnus-select a5db603 137/218: Minor improvements in building.texi, (continued)
- [Emacs-diffs] feature/gnus-select a5db603 137/218: Minor improvements in building.texi, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 7325e18 146/218: * cc-engine.el (c-looking-at-or-maybe-in-bracelist): Remove pessimization, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select cbea6b1 145/218: Avoid redisplay problems with too wide wrap-prefix, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 3b5438f 148/218: Revert "Support all perl variable declarators and prefixes", Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select e31b277 152/218: * lisp/play/fortune.el (fortune-in-buffer): Unadvertise no-op arg., Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 246460c 155/218: Add tests for Bug#30408, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select d219c99 143/218: Autoupdate from Gnulib, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select b6d216c 169/218: Tag tramp-test39-utf8* as :unstable, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select b74e19e 159/218: * lisp/play/fortune.el (fortune-in-buffer): Revert previous nonsense., Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select e3bcd11 160/218: Port data-tests-popcnt to 32-bit Emacs, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 19ed176 149/218: Improvements in dired.texi,
Andrew G Cohen <=
- [Emacs-diffs] feature/gnus-select 5f36db7 167/218: Improve warning and error messages, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 0bf81e2 174/218: ; Fix last commit in tramp.el, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 219d6cf 180/218: * doc/lispref/anti.texi (Antinews): Fix grammar., Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 7f60bfe 175/218: Port emacs-module-tests to 32-bit Emacs, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 9fabadf 179/218: Add new command vc-git-stash-delete, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 3ff0a07 182/218: Try and fix the more obvious sources of bug#30635, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 4a80595 192/218: Fix too-large integer in Hg backend, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 992a8ec 187/218: * src/lisp.h (struct Lisp_Buffer_Local_Value): Update commentary., Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 17a41a9 191/218: Avoid Fortran-style floating-point optimization, Andrew G Cohen, 2018/12/14
- [Emacs-diffs] feature/gnus-select 6eddea6 193/218: * src/process.c (Fsignal_process): Simplify., Andrew G Cohen, 2018/12/14