From 4f45af16385900f53d5bc5b816c50286d7f152d3 Mon Sep 17 00:00:00 2001
From: Axel Beckert <abe@deuxchevaux.org>
Date: Sat, 29 Dec 2012 02:43:09 +0100
Subject: [PATCH] Add examples section to man page (Closes: #380327)

---
 debian/changelog                      |  1 +
 debian/patches/man-page-examples.diff | 54 +++++++++++++++++++++++++++
 debian/patches/series                 |  1 +
 3 files changed, 56 insertions(+)
 create mode 100644 debian/patches/man-page-examples.diff

diff --git a/debian/changelog b/debian/changelog
index 0eed063..7454d99 100644
--- 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
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 eb8733d..67439b4 100644
--- 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
-- 
2.39.2