[libconfig-model-dpkg-perl] 09/10: C::M::Dpkg.pm: updated pod doc for check on arbitrary files

[dod at debian.org]

This is an automated email from the git hooks/post-receive script.

dod pushed a commit to branch master
in repository libconfig-model-dpkg-perl.

commit 3d9ea91fdc794a700236c29222279d8821bb4082
Author: Dominique Dumont <dod at debian.org>
Date:   Thu Mar 6 19:00:16 2014 +0100

    C::M::Dpkg.pm: updated pod doc for check on arbitrary files
---
 lib/Config/Model/Dpkg.pm | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/lib/Config/Model/Dpkg.pm b/lib/Config/Model/Dpkg.pm
index 15b4ac0..dc1ffdd 100644
--- a/lib/Config/Model/Dpkg.pm
+++ b/lib/Config/Model/Dpkg.pm
@@ -29,7 +29,7 @@ You can choose to edit only C<debian/control> or C<debian/copyright>:
 
 You can also use L<cme> to run sanity checks on the source files:
 
- cme check dpkg 
+ cme check dpkg
 
 =head2 Fix warnings
 
@@ -38,6 +38,18 @@ You can choose to  fix (most of) these warnings with the command:
 
  cme fix dpkg
 
+=head2 check and arbitrary file
+
+you can specify another file to check:
+
+  cme check dpkg-copyright foobar
+
+or use standard input:
+
+  GET http://ftp-master.metadata.debian.org/changelogs/main/s/shutter/unstable_copyright | cme check dpkg-copyright -
+
+This applies only to C<dpkg-control> and C<dpkg-copyright>.
+
 =head2 programmatic
 
 This code snippet will change the maintainer address in control file:
@@ -90,7 +102,7 @@ This migration can be limited to C<control> or C<copyright> files:
 
 Restore GPL summary to default value:
 
-  cme modify dpkg-copyright 'License=~/GPL/ text~'
+  cme modify dpkg-copyright ~~ 'License=~/GPL/ text~'
 
 Dump copyright file content in a format usable with C<cme modify>:
 
@@ -111,6 +123,15 @@ Dump copyright file content in a format usable with C<cme modify>:
      On Debian GNU/Linux systems, the complete text of version 2.1 of the GNU
      Lesser General Public License can be found in `/usr/share/common-licenses/LGPL-2.1'" - -
 
+=head2 modify a value with the command line:
+
+ cme modify dpkg-copyright ~~ 'Comment="Modified with cme"'
+
+Or apply more systematic changes. This example updates copyright years for all
+C<Files> entries in C<debian/copyright>:
+
+ cme modify dpkg-copyright ~~ 'Files:~/./ Copyright=~"s/2013/2014/"'
+
 =head1 BUGS
 
 Config::Model design does not really cope well with a some detail of

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libconfig-model-dpkg-perl.git