about summary refs log tree commit diff
path: root/Doc
diff options
context:
space:
mode:
authorPeter Stephenson <p.w.stephenson@ntlworld.com>2015-08-17 20:22:20 +0100
committerPeter Stephenson <p.w.stephenson@ntlworld.com>2015-08-17 20:22:20 +0100
commitbd89f38fb79d6229d6c44f06cb1c1c4fd02556ed (patch)
tree70d8830229fac741423924de8cffa4b3c0662537 /Doc
parent1d2dd33c0ac451f04308b8edd8528ac7ca90cf05 (diff)
downloadzsh-bd89f38fb79d6229d6c44f06cb1c1c4fd02556ed.tar.gz
zsh-bd89f38fb79d6229d6c44f06cb1c1c4fd02556ed.tar.xz
zsh-bd89f38fb79d6229d6c44f06cb1c1c4fd02556ed.zip
unposted: use of $f in zmv
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/contrib.yo11
1 files changed, 10 insertions, 1 deletions
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index 63efaf923..4e87d4116 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -3834,7 +3834,12 @@ The pattern is always treated as an tt(EXTENDED_GLOB) pattern.  Any file
 whose name is not changed by the substitution is simply ignored.  Any
 error (a substitution resulted in an empty string, two substitutions gave
 the same result, the destination was an existing regular file and tt(-f)
-was not given) causes the entire function to abort without doing anything.
+was not given) causes the entire function to abort without doing
+anything.
+
+In addition to pattern replacement, the variable tt($f) can be referrred
+to in the second (replacement) argument.  This makes it possible to
+use variable substitution to alter the argument; see examples below.
 
 Options:
 
@@ -3883,6 +3888,10 @@ example(zmv -v '(* *)' '${1// /_}')
 For any file in the current directory with at least one space in the name,
 replace every space by an underscore and display the commands executed.
 
+example(zmv -v '* *' '${f// /_}')
+
+This does exactly the same by referring to the file name stored in tt($f).
+
 For more complete examples and other implementation details, see the
 tt(zmv) source file, usually located in one of the directories named in
 your tt(fpath), or in tt(Functions/Misc/zmv) in the zsh distribution.