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