procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarify the documentation of 'dired-recursive-deletes'

Browse source 
* doc/emacs/dired.texi (Dired Deletion): Clarify text regarding
recursive deletion of non-empty directories.  (Bug#31529)
This commit is contained in:
Eli Zaretskii 2018-06-09 11:58:27 +03:00
parent 9db97b49cd
commit 5b6f8b54d1
1 changed files with 15 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

28
doc/emacs/dired.texi
View file

@ -238,19 +238,21 @@ the buffer, and no files actually deleted.
@cindex recursive deletion @cindex recursive deletion
@vindex dired-recursive-deletes @vindex dired-recursive-deletes
You can delete empty directories just like other files, but normally You can delete empty directories just like other files, but normally
Dired cannot delete directories that are nonempty. If the variable Dired cannot delete directories that are nonempty. However, if the
@code{dired-recursive-deletes} is non-@code{nil}, then Dired can variable @code{dired-recursive-deletes} is non-@code{nil}, then Dired
delete nonempty directories including all their contents. That can be is allowed to delete nonempty directories including all their
somewhat risky. If the value of the variable is @code{always}, Dired contents. That can be somewhat risky. If the value of the variable
will delete nonempty directories recursively, which is even more is @code{always}, Dired will delete nonempty directories recursively,
risky. Even if you have set @code{dired-recursive-deletes} to which is even more risky.
@code{nil}, you might want sometimes to delete recursively directories
without being asked for confirmation for all of them. This is handy Even if you have set @code{dired-recursive-deletes} to @code{nil}, you
when you have marked many directories for deletion and you are very might want sometimes to delete directories recursively without being
sure that all of them can safely be deleted. For every nonempty asked for confirmation for all of them. For example, you may want
directory you are asked for confirmation; if you answer @code{all}, that when you have marked many directories for deletion and you are
then all the remaining directories will be deleted without more very sure that all of them can safely be deleted. For every nonempty
questions. directory you are asked for confirmation to delete, if you answer
@code{all}, then all the remaining directories will be deleted without
any further questions.
@vindex delete-by-moving-to-trash@r{, and Dired} @vindex delete-by-moving-to-trash@r{, and Dired}
If you change the variable @code{delete-by-moving-to-trash} to If you change the variable @code{delete-by-moving-to-trash} to