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

dired.texi: Document dired-create-destination-dirs-on-trailing-dirsep

Browse source 
* doc/emacs/dired.texi (Operating on Files): Document new option
dired-create-destination-dirs-on-trailing-dirsep.
This commit is contained in:
Tassilo Horn 2021-12-06 21:24:56 +01:00
parent dd2a994f0c
commit 4eb749a173
1 changed files with 17 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
doc/emacs/dired.texi
View file

@ -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.