r43401 - in /trunk/libxml-sax-machines-perl/debian: changelog patches/series patches/siteconfig-warning.patch

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

Author: jawnsy-guest
Date: Tue Sep  1 19:14:10 2009
New Revision: 43401

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=43401
Log:
Add a warning in the docs for the SiteConfig.pm issue (Closes: #537582)

Added:
    trunk/libxml-sax-machines-perl/debian/patches/siteconfig-warning.patch
Modified:
    trunk/libxml-sax-machines-perl/debian/changelog
    trunk/libxml-sax-machines-perl/debian/patches/series

Modified: trunk/libxml-sax-machines-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libxml-sax-machines-perl/debian/changelog?rev=43401&op=diff
==============================================================================
--- trunk/libxml-sax-machines-perl/debian/changelog (original)
+++ trunk/libxml-sax-machines-perl/debian/changelog Tue Sep  1 19:14:10 2009
@@ -15,6 +15,7 @@
   * Cleaned up Copyright
   * debhelper 7 upgrade
   * Rewrote control file description
+  * Add a warning in the docs for the SiteConfig.pm issue (Closes: #537582)
 
   [ gregor herrmann ]
   * Add debian/README.source to document quilt usage, as required by

Modified: trunk/libxml-sax-machines-perl/debian/patches/series
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libxml-sax-machines-perl/debian/patches/series?rev=43401&op=diff
==============================================================================
--- trunk/libxml-sax-machines-perl/debian/patches/series (original)
+++ trunk/libxml-sax-machines-perl/debian/patches/series Tue Sep  1 19:14:10 2009
@@ -1,1 +1,2 @@
 pod-warnings.patch
+siteconfig-warning.patch

Added: trunk/libxml-sax-machines-perl/debian/patches/siteconfig-warning.patch
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libxml-sax-machines-perl/debian/patches/siteconfig-warning.patch?rev=43401&op=file
==============================================================================
--- trunk/libxml-sax-machines-perl/debian/patches/siteconfig-warning.patch (added)
+++ trunk/libxml-sax-machines-perl/debian/patches/siteconfig-warning.patch Tue Sep  1 19:14:10 2009
@@ -1,0 +1,25 @@
+Description: warning about XML::SAX::Machines::SiteConfig and upgrades
+ SiteConfig.pm is a Perl module which is supposed to be used for system
+ configuration of the XML-SAX-Machines module, rather than changing
+ things in ConfigDefaults. The problem is that on Debian systems, this
+ file is installed in /usr/share/perl5, rather than /etc/perl, which
+ means that any changes will be silently overwritten upon an upgrade,
+ which would clobber a user's changes. The proposed fix for this is to
+ add a documentation patch explaining this behaviour.
+Bug: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537582
+Origin: vendor
+Author: Jonathan Yu <jawnsy at cpan.org>
+--- a/lib/XML/SAX/Machines.pm
++++ b/lib/XML/SAX/Machines.pm
+@@ -143,8 +143,9 @@
+ 
+     XML::Filter::Tee->new( Handler => $h );
+ 
+-B<WARNING> If you modify anything, modify only
+-XML::SAX::Machines::SiteConfig.pm.  Don't alter
++B<WARNING> If you modify anything, apply your changes in a new file created
++from XML::SAX::Machines::SiteConfig.pm. On Debian systems, this should be placed
++in /etc/perl so that it is not overwritten during upgrade.  Do not alter
+ XML::SAX::Machines::ConfigDefaults.pm or you will lose your changes when you
+ upgrade.
+