Add examples section to man page (Closes: #380327)

diff --git a/debian/changelog b/debian/changelog
index 0eed0637bb7bedb685a912728647e4817ea6f322..7454d993ad72cd80f76bd2c46a342150d433b268 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ mmv (1.01b-16) UNRELEASED; urgency=low
   * Switch to source format "3.0 (quilt)"
   * Add slightly modified patch by Ulrich Eckhardt to provide better
     diagnostics for directory renaming (Closes: #584850)
+  * Add examples section to man page (Closes: #380327)
   * Rewrite debian/rules with oldstyle debhelper utilities
     + Use compat-level 9
     + Add build-dependency on debhelper >= 9~

diff --git a/debian/patches/man-page-examples.diff b/debian/patches/man-page-examples.diff
new file mode 100644 (file)
index 0000000..706f88a
--- /dev/null
+++ b/debian/patches/man-page-examples.diff
@@ -0,0 +1,54 @@
+Description: Add examples section to man page
+ This patch adds several examples of common mmv usage to the man page
+Debian-Bug: 380327
+Author: Axel Beckert <abe@debian.org>
+Last-Update: 2012-12-29
+
+Index: mmv/mmv.1
+===================================================================
+--- mmv.orig/mmv.1     2012-12-29 02:20:59.510075480 +0100
++++ mmv/mmv.1  2012-12-29 02:39:33.591699513 +0100
+@@ -35,6 +35,43 @@
+ .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,

diff --git a/debian/patches/series b/debian/patches/series
index eb8733d662c798a064a1828e9a6f34c6fabad812..67439b4f189f951739db7a6b59de8ab5f8fb69cc 100644 (file)
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -2,3 +2,4 @@ patches-as-of-mmv-1.01b-15.diff
 man-page-fixes.diff
 format-security.diff
 better-diagnostics-for-directories-584850.diff
+man-page-examples.diff