From 4eb749a17310952af02293d3e55ea3b75660002a Mon Sep 17 00:00:00 2001 From: Tassilo Horn Date: Mon, 6 Dec 2021 21:24:56 +0100 Subject: [PATCH] dired.texi: Document dired-create-destination-dirs-on-trailing-dirsep * doc/emacs/dired.texi (Operating on Files): Document new option dired-create-destination-dirs-on-trailing-dirsep. --- doc/emacs/dired.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index 0edd8bc7da0..48cf5630eea 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi @@ -742,6 +742,15 @@ never creates such missing directories; the value @code{always}, means Dired automatically creates them; the value @code{ask} means Dired asks you for confirmation before creating them. +@vindex dired-create-destination-dirs-on-trailing-dirsep +If the option @code{dired-create-destination-dirs-on-trailing-dirsep} +is non-@code{nil} in addition to @code{dired-create-destination-dirs}, +a trailing directory separator at the destination directory is treated +specially. In that case, when copying to @samp{test/} and no +directory @samp{test} exists already, it will be created and the +specified source files or directories are copied into the newly +created directory. + @vindex dired-copy-preserve-time If @code{dired-copy-preserve-time} is non-@code{nil}, then copying with this command preserves the modification time of the old file in @@ -784,6 +793,14 @@ which to move the files (this is like the shell command @command{mv}). The option @code{dired-create-destination-dirs} controls whether Dired should create non-existent directories in @var{new}. +The option @code{dired-create-destination-dirs-on-trailing-dirsep}, +when set in addition to @code{dired-create-destination-dirs}, controls +wether a trailing directory separator at the destination is treated +specially. In that case, when renaming a directory @samp{old} to +@samp{new/} and no directory @samp{new} exists already, it will be +created and @samp{old} is moved into the newly created directory. +Otherwise, @samp{old} is renamed to @samp{new}. + Dired automatically changes the visited file name of buffers associated with renamed files so that they refer to the new names. -- 2.39.2