[libconfig-model-dpkg-perl] 02/02: C::M::Dpkg: added cme examples in pod doc

[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 1aeaee52f888166746c3f7c228143bfd7eff8cf4
Author: Dominique Dumont <dod at debian.org>
Date:   Fri Nov 1 18:32:34 2013 +0100

    C::M::Dpkg: added cme examples in pod doc
---
 lib/Config/Model/Dpkg.pm |   43 ++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 40 insertions(+), 3 deletions(-)

diff --git a/lib/Config/Model/Dpkg.pm b/lib/Config/Model/Dpkg.pm
index f607d90..508f850 100644
--- a/lib/Config/Model/Dpkg.pm
+++ b/lib/Config/Model/Dpkg.pm
@@ -14,11 +14,12 @@ Config::Model::Dpkg - Edit and validate Dpkg source files
 
 =head2 invoke editor
 
-The following command must be run in a package source directory. Whenrun, L<cme> 
-will load most files from C<debian> directory and launch a graphical editor:
+The following command must be run in a package source
+directory. Whenrun, L<cme> will load most files from C<debian>
+directory and launch a graphical editor:
 
  cme edit dpkg
- 
+
 You can choose to edit only C<debian/control> or C<debian/copyright>:
 
  cme edit dpkg-control
@@ -74,6 +75,42 @@ if L<Fuse> is installed (Linux only)
 
 =back
 
+=head1 Examples
+
+=head2 Migrate old package file
+
+Most of old syntax can be automatically migrated to newer parameters with
+
+  cme migrate dpkg
+
+This migration can be limited to C<control> or C<copyright> files:
+
+  cme migrate dpkg-control
+  cme migrate dpkg-copyright
+
+Restore GPL summary to default value:
+
+  cme modify dpkg-copyright 'License=~/GPL/ text~'
+
+Dump copyright file content in a format usable with C<cme modify>:
+
+  $ cme dump dpkg-copyright
+  Comment="Native package. This package is a spin-off from
+  libconfig-model-perl. Upstream (who is also the debian packager)
+  decided to create a Debian native package for the Debian specific
+  parts of Config::Model"
+  Files:"*"
+    Copyright="2005-2013, Dominique Dumont <dod at debian.org>"
+    License
+      short_name=LGPL-2.1+ - -
+  License:LGPL-2.1+
+    text="   This program is free software; you can redistribute it and/or modify
+     it under the terms of the GNU Lesser General Public License as
+     published by the Free Software Foundation; either version 2.1 of the
+     License, or (at your option) any later version.
+     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'" - -
+
 =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