r39659 - in /trunk/libconfig-model-perl/debian: changelog dh/dh_config libconfig-model-perl.install

[ddumont-guest at users.alioth.debian.org]

Author: ddumont-guest
Date: Fri Jul 10 11:56:17 2009
New Revision: 39659

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=39659
Log:
added doc and copyright to dh_config. RFC time

Added:
    trunk/libconfig-model-perl/debian/libconfig-model-perl.install
Modified:
    trunk/libconfig-model-perl/debian/changelog
    trunk/libconfig-model-perl/debian/dh/dh_config

Modified: trunk/libconfig-model-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-model-perl/debian/changelog?rev=39659&op=diff
==============================================================================
--- trunk/libconfig-model-perl/debian/changelog (original)
+++ trunk/libconfig-model-perl/debian/changelog Fri Jul 10 11:56:17 2009
@@ -1,3 +1,9 @@
+libconfig-model-perl (0.638-2) UNRELEASED; urgency=low
+
+  * added dh_config and postinst snippet
+
+ -- Dominique Dumont <dominique.dumont at hp.com>  Thu, 09 Jul 2009 14:52:55 +0200
+
 libconfig-model-perl (0.638-1) unstable; urgency=low
 
   * New upstream release: small bug fix 

Modified: trunk/libconfig-model-perl/debian/dh/dh_config
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-model-perl/debian/dh/dh_config?rev=39659&op=diff
==============================================================================
--- trunk/libconfig-model-perl/debian/dh/dh_config (original)
+++ trunk/libconfig-model-perl/debian/dh/dh_config Fri Jul 10 11:56:17 2009
@@ -1,4 +1,21 @@
 #!/usr/bin/perl
+
+#    Copyright (c) 2009 Dominique Dumont.
+#
+#    This library is free software; you can redistribute it and/or
+#    modify it under the terms of the GNU Lesser Public License as
+#    published by the Free Software Foundation; either version 2.1 of
+#    the License, or (at your option) any later version.
+#
+#    Config-Model is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    Lesser Public License for more details.
+#
+#    You should have received a copy of the GNU Lesser Public License
+#    along with Config-Model; if not, write to the Free Software
+#    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+#    02110-1301 USA
 
 # dh_config file provided by libconfig-model-perl package
 
@@ -53,4 +70,84 @@
 # calls autoscript to update pkg.postinst with config-edit command
 autoscript($package,postinst => 'postinst-config-model') ;
 
+__END__
 
+=head1 NAME
+
+dh_config - add Config::Model based configuration merge
+
+=head1 SYNOPSIS
+
+ dh_config [ debhelper options ] [ -model_name xx ] \
+  [ -model_package xx [ -model_version yy ] ]
+
+=head1 DESCRIPTION
+
+dh_config is a debhelper that will modify the package script to
+perform configuration merge on package upgrade. This merge is based on
+L<config-edit> from L<Config::Model>.
+
+Model informations can be specified by command options or a
+configuration file: C<debian/foo.config-model>
+
+A Model must be either :
+
+=over
+
+=item *
+
+Delivered in the package in C<debian/config-model/models/> directory
+
+=item *
+
+Provided by another package
+
+=back
+
+=head1 OPTIONS
+
+=head2 -model_name XX
+
+Specifies the model name (à la C<Config::Model>) that will be used to
+perform the upgrade. Without this information, C<dh_config> will do
+nothing.
+
+=head2 -model_package XX
+
+Specifies the debian package that provide the model specified bu
+C<-model_name>.
+
+=head2 -model_version YY
+
+Specifies the minimal version of the package that provides the model.
+
+=head1 EXAMPLE
+
+Here's a example based on C<approx> package where the model file and
+the parser/writer are delivered in approx package.
+
+Debian dir contains:
+
+  debian/config-model/Approx.pm
+  debian/config-model/models/Approx.pl
+
+C<debian/approx.install> contains:
+
+  debian/config-model/Approx.pm usr/share/perl5/Config/Model
+  debian/config-model/models/Approx.pl usr/share/perl5/Config/Model/models
+
+dh_config is invoked as :
+
+  dh_config -model_name Approx
+
+=head1 SEE ALSO
+
+L<debhelper>
+
+This program is an addendum to debhelper (part of libconfig-model-perl).
+
+=head1 AUTHOR
+
+Dominique Dumont <ddumont at cpan.org>
+
+=cut

Added: trunk/libconfig-model-perl/debian/libconfig-model-perl.install
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-model-perl/debian/libconfig-model-perl.install?rev=39659&op=file
==============================================================================
--- trunk/libconfig-model-perl/debian/libconfig-model-perl.install (added)
+++ trunk/libconfig-model-perl/debian/libconfig-model-perl.install Fri Jul 10 11:56:17 2009
@@ -1,0 +1,2 @@
+debian/dh/dh_config usr/bin/
+debian/dh/postinst-config-model usr/share/debhelper/autoscripts/