summary refs log tree commit diff
path: root/Doc
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2013-07-03 12:46:02 +0100
committerPeter Stephenson <pws@zsh.org>2013-07-03 12:46:02 +0100
commit669c070efe06d1820ccb32adaa6b1512279401ab (patch)
treead4b7f890e6ab3e19c71e4316483eeb61c576ec1 /Doc
parent96c8b2832b4f2237cb78f4616c905d9b4b0cf53e (diff)
downloadzsh-669c070efe06d1820ccb32adaa6b1512279401ab.tar.gz
zsh-669c070efe06d1820ccb32adaa6b1512279401ab.tar.xz
zsh-669c070efe06d1820ccb32adaa6b1512279401ab.zip
31503: zmv improvements for user-specified programs.
-p splits words of commands passed to it.
-P is like -p for when the program doesn't understand the -- convention
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/contrib.yo10
1 files changed, 8 insertions, 2 deletions
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index b191e10d9..06e7ed076 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -3618,7 +3618,7 @@ ifzman(above)\
 ifnzman((noderef(Utilities))).
 )
 findex(zmv)
-item(tt(zmv) [ tt(-finqQsvwW) ] [ -C | -L | -M | -p var(program) ] [ -o var(optstring) ] var(srcpat) var(dest) )(
+item(tt(zmv) [ tt(-finqQsvwW) ] [ -C | -L | -M | -[pP] var(program) ] [ -o var(optstring) ] var(srcpat) var(dest) )(
 Move (usually, rename) files matching the pattern var(srcpat) to
 corresponding files having names of the form given by var(dest), where
 var(srcpat) contains parentheses surrounding patterns which will be
@@ -3663,7 +3663,13 @@ sitem(tt(-p) var(program))(Call var(program) instead of tt(cp), tt(ln) or
 tt(mv).  Whatever it does, it should at least understand the form
 ifzman(`var(program) tt(-)tt(-) var(oldname) var(newname)')\
 ifnzman(example(var(program) tt(-)tt(-) var(oldname) var(newname)))
-where var(oldname) and var(newname) are filenames generated by tt(zmv).)
+where var(oldname) and var(newname) are filenames generated by tt(zmv).
+var(program) will be split into words, so might be e.g. the name
+of an archive tool plus a copy or rename subcommand.)
+sitem(tt(-P) var(program))(As tt(-p) var(program), except that
+var(program) does not accept a following tt(-)tt(-) to indicate the
+end of options.  In this case filenames must already be in a sane
+form for the program in question.)
 sitem(tt(-o) var(optstring))(The var(optstring) is split into words and
 passed down verbatim to the tt(cp), tt(ln) or tt(mv) command called to
 perform the work.  It should probably begin with a `tt(-)'.)