[libconfig-model-dpkg-perl] 11/12: Config::Model::Dpkg: added cme examples on 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 209d610be1aa1478d72deb5ee544f9f04e3736d8
Author: Dominique Dumont <dod at debian.org>
Date:   Wed Mar 26 20:58:48 2014 +0100

    Config::Model::Dpkg: added cme examples on pod doc
---
 lib/Config/Model/Dpkg.pm | 73 ++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 70 insertions(+), 3 deletions(-)

diff --git a/lib/Config/Model/Dpkg.pm b/lib/Config/Model/Dpkg.pm
index 006ebb1..fc5ebfd 100644
--- a/lib/Config/Model/Dpkg.pm
+++ b/lib/Config/Model/Dpkg.pm
@@ -33,7 +33,7 @@ You can also use L<cme> to run sanity checks on the source files:
 
 =head2 Fix warnings
 
-When run, cme may issue several warnings regarding the content of your file. 
+When run, cme may issue several warnings regarding the content of your file.
 You can choose to  fix (most of) these warnings with the command:
 
  cme fix dpkg
@@ -63,7 +63,7 @@ This code snippet will change the maintainer address in control file:
 
 =head1 DESCRIPTION
 
-This module provides a configuration editor (and models) for the 
+This module provides a configuration editor (and models) for the
 files of a Debian source package. (i.e. most of the files contained in the
 C<debian> directory of a source package).
 
@@ -82,11 +82,45 @@ A graphical interface is proposed by default if L<Config::Model::TkUI> is instal
 
 =item *
 
-A L<Fuse> virtual file system with option C<< cme fusefs dpkg -fuse_dir <mountpoint> >> 
+A L<Fuse> virtual file system with option C<< cme fusefs dpkg -fuse_dir <mountpoint> >>
 if L<Fuse> is installed (Linux only)
 
 =back
 
+=head2 package dependency checks
+
+Package dependencies are checked on several points:
+
+=over
+
+=item *
+
+Whether the package is available in Debian (from sid to old-stable)
+
+=item *
+
+If the package is a known virtual package. Known means listed in Debian packaging manual or known by the
+author. Feel free to log a bug against libconfig-model-dpkg-perl if a virtual package is missing. But please
+don't log a bug if the virtual package is used only during a transition.
+
+=item *
+
+If a package older that the required version are available in Debian (from sid to old-stable). If not, L<cme>
+will offer you the possibility to clean up the versioned dependency with C<cme fix dpkg> command.
+
+=item *
+
+The syntax of the dependency (including version requirement and arch specification).
+
+=item *
+
+Consistency of alternate dependency for Perl libraries
+
+=back
+
+These checks only generate warnings. Most of these checks can be fixed with C<cme fix dpkg> command.
+
+
 =head1 Examples
 
 =head2 Migrate old package file
@@ -132,6 +166,39 @@ C<Files> entries in C<debian/copyright>:
 
  cme modify dpkg-copyright ~~ 'Files:~/./ Copyright=~"s/2013/2014/"'
 
+=head2 remove an uploader from control files
+
+ cme modify dpkg control source Uploaders:-~/johndoe/
+
+or
+
+ cme modify dpkg-control ~~ source Uploaders:-~/dod/
+
+If you want to remove a guy named Ian, you'll have to be a little more specific to avoid removing
+all debian developers:
+
+ cme modify dpkg-control ~~ source Uploaders:-="Ian Smith<iansmith at debian.org>"
+
+=head2 add a new uploader
+
+The quotes are required otherwise bash will complain. These 2 commands give the same results:
+
+ cme modify dpkg-control ~~ 'source Uploaders:<"John Doe<johndoe at foo.com>"'
+ cme modify dpkg-control ~~ 'source Uploaders:.push("John Doe<johndoe at foo.com>")'
+
+Add an uploader to a sorted list of Uploaders (yes, insort, with a 'o', not "insert" with a 'e'):
+
+ cme modify dpkg-control ~~ 'source Uploaders:.insort("John Doe<johndoe at foo.com>")'
+
+The above command make sense only if the list is sorted. Let's sort the list of uploaders:
+
+ cme modify dpkg-control ~~ 'source Uploaders:@'
+ cme modify dpkg-control ~~ 'source Uploaders:.sort'
+
+The 2 commands can be combined:
+
+ cme modify dpkg-control ~~ 'source Uploaders:.sort Uploaders:.insort("John Doe<johndoe at foo.com>")'
+
 =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