mirror of
https://git.freebsd.org/ports.git
synced 2025-06-11 15:50:33 -04:00
06ef9fa33e
Add LICENSE based on the contents of file ANNOUNCE in the sources. Approved by: antoine (mentor)
120 lines
3.2 KiB
Groff
120 lines
3.2 KiB
Groff
--- mmv.1.orig 2017-10-24 14:25:26 UTC
|
|
+++ mmv.1
|
|
@@ -35,6 +35,43 @@ mmv \- move/copy/append multiple files by wildcard pat
|
|
.B mmvpatch
|
|
[\fBexecutable\fP]
|
|
\}
|
|
+.SH "EXAMPLES"
|
|
+Rename all
|
|
+.I *.jpeg
|
|
+files in the current directory to
|
|
+\fI*.jpg\fR:
|
|
+
|
|
+.in +3
|
|
+mmv '*.jpeg' '#1.jpg'
|
|
+.in -3
|
|
+
|
|
+Replace the first occurrence of
|
|
+.I abc
|
|
+with
|
|
+.I xyz
|
|
+in all files in the current directory:
|
|
+
|
|
+.in +3
|
|
+mmv '*abc*' '#1xyz#2'
|
|
+.in -3
|
|
+
|
|
+Rename files ending in \fI.html.en\fR, \fI.html.de\fR, etc. to ending
|
|
+in \fI.en.html\fR, \fI.de.html\fR, etc. in the current directory:
|
|
+
|
|
+.in +3
|
|
+mmv '*.html.??' '#1.#2#3.html'
|
|
+.in -3
|
|
+
|
|
+Rename music files from
|
|
+.I <track no.> - <interpreter> - <song title>.ogg
|
|
+to
|
|
+.I <interpreter> - <track no.> - <song title>.ogg
|
|
+in the current directory:
|
|
+
|
|
+.in +3
|
|
+mmv '* - * - *.ogg' '#2 - #1 - #3.ogg'
|
|
+.in -3
|
|
+
|
|
.SH "DESCRIPTION"
|
|
.I Mmv
|
|
moves (or copies,
|
|
@@ -196,8 +233,13 @@ and it applies to all matching files.
|
|
Remaining options need not be given separately,
|
|
i.e. "mmv \-mk" is allowed.
|
|
|
|
+\fBWARNING:\fR This operation mode does \fBnot\fR work if the patterns
|
|
+itself contain \fBspaces\fR. See
|
|
+.I http://bugs.debian.org/149873
|
|
+for details.
|
|
+
|
|
.ce
|
|
-Multiple Pattern Pairs
|
|
+Multiple Pattern Pairs / Reading Patterns from STDIN
|
|
.PP
|
|
Multiple
|
|
.I from
|
|
@@ -240,6 +282,11 @@ would give the error message "a \-> c : no match" beca
|
|
(even if it exists)
|
|
was already matched by the first pattern pair.
|
|
|
|
+\fBWARNING:\fR This operation mode does \fBnot\fR work if the patterns
|
|
+itself contain \fBspaces\fR. See
|
|
+.I http://bugs.debian.org/149873
|
|
+for details.
|
|
+
|
|
.ce
|
|
The \fIFrom\fP Pattern
|
|
.PP
|
|
@@ -350,7 +397,7 @@ pattern is a filename
|
|
with embedded
|
|
.I wildcard
|
|
.IR indexes ,
|
|
-where an index consists of the character '#'
|
|
+where an index consists of the character '#' or '='
|
|
followed by a string of digits.
|
|
When a source file matches a
|
|
.I from
|
|
@@ -411,7 +458,7 @@ if "dir2" is indeed a directory, actually move "dir1\*
|
|
However, if "dir2\*(SLa" already exists and is itself a directory,
|
|
this is considered an error.
|
|
.PP
|
|
-To strip any character (e.g. '*', '?', or '#')
|
|
+To strip any character (e.g. '*', '?', '#', or '=')
|
|
of its special meaning to
|
|
.IR mmv ,
|
|
as when the actual replacement name must contain the character '#',
|
|
@@ -555,6 +602,12 @@ and will accept pattern pairs with or without the inte
|
|
Lines with "(*)" after the target pattern have the effect of enabling \-d
|
|
for the files matching this pattern only,
|
|
so that such deletions are done silently.
|
|
+
|
|
+\fBWARNING:\fR This means that \fBunexpected things\fR may happen if
|
|
+\fBfiles\fR matched by the patterns contain \fBspaces\fR. See
|
|
+.I http://bugs.debian.org/149873
|
|
+for details.
|
|
+
|
|
When feeding
|
|
.I mmv
|
|
its own output,
|
|
@@ -644,6 +697,15 @@ and with status 0 otherwise.
|
|
.SH "SEE ALSO"
|
|
mv(1), cp(1), ln(1), umask(1)
|
|
\}
|
|
+.SH "HISTORY"
|
|
+The original FreeBSD port of mmv was derived from the Usenet
|
|
+comp.sources.unix postings <2438@litchi.bbn.com>,
|
|
+<2439@litchi.bbn.com>, and <2643@litchi.bbn.com>.
|
|
+The current port is based on the comp.binaries.ibm.pc postings
|
|
+(no messageids available).
|
|
+The Unix version used '=' as the index escape character,
|
|
+while the MS-DOS version used '#'.
|
|
+This port allows both.
|
|
.SH "AUTHOR"
|
|
Vladimir Lanin
|
|
.br
|