debian/patches/man-page-examples.diff

   1 Description: Add examples section to man page
   2  This patch adds several examples of common mmv usage to the man page
   3 Debian-Bug: 380327
   4 Author: Axel Beckert <abe@debian.org>
   5 Last-Update: 2012-12-29
   6
   7 Index: mmv/mmv.1
   8 ===================================================================
   9 --- mmv.orig/mmv.1      2012-12-29 02:20:59.510075480 +0100
  10 +++ mmv/mmv.1   2012-12-29 02:39:33.591699513 +0100
  11 @@ -35,6 +35,43 @@
  12  .B mmvpatch
  13  [\fBexecutable\fP]
  14  \}
  15 +.SH "EXAMPLES"
  16 +Rename all
  17 +.I *.jpeg
  18 +files in the current directory to
  19 +\fI*.jpg\fR:
  20 +
  21 +.in +3
  22 +mmv '*.jpeg' '#1.jpg'
  23 +.in -3
  24 +
  25 +Replace the first occurrence of
  26 +.I abc
  27 +with
  28 +.I xyz
  29 +in all files in the current directory:
  30 +
  31 +.in +3
  32 +mmv '*abc*' '#1xyz#2'
  33 +.in -3
  34 +
  35 +Rename files ending in \fI.html.en\fR, \fI.html.de\fR, etc. to ending
  36 +in \fI.en.html\fR, \fI.de.html\fR, etc. in the current directory:
  37 +
  38 +.in +3
  39 +mmv '*.html.??' '#1.#2#3.html'
  40 +.in -3
  41 +
  42 +Rename music files from
  43 +.I <track no.> - <interpreter> - <song title>.ogg
  44 +to
  45 +.I <interpreter> - <track no.> - <song title>.ogg
  46 +in the current directory:
  47 +
  48 +.in +3
  49 +mmv '* - * - *.ogg' '#2 - #1 - #3.ogg'
  50 +.in -3
  51 +
  52  .SH "DESCRIPTION"
  53  .I Mmv
  54  moves (or copies,