File: siteconfig-warning.patch

package info (click to toggle)
libxml-sax-machines-perl 0.46-1
  • links: PTS, VCS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, stretch
  • size: 436 kB
  • ctags: 159
  • sloc: perl: 1,767; makefile: 9
file content (29 lines) | stat: -rw-r--r-- 1,305 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
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.
Origin: vendor
Bug: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537582
Forwarded: not-needed
Author: Jonathan Yu <jawnsy@cpan.org>
Reviewed-by: gregor herrmann <gregoa@debian.org>
Last-Update: 2013-10-11

--- a/lib/XML/SAX/Machines.pm
+++ b/lib/XML/SAX/Machines.pm
@@ -319,8 +319,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.