Seconded: Bill Allombert <ballombe@debian.org>
Seconded: Jakub Wilk <jwilk@debian.org>
Closes: #617516
+ * Perl policy: Document major version upgrade trigger
+ Wording: Dominic Hargreaves <dom@debian.org>
+ Seconded: Russ Allbery <rra@debian.org>
+ Seconded: Niko Tyni <ntyni@debian.org>
+ Seconded: Gregor Herrmann <gregoa@debian.org>
+ Closes: #619275
- -- Bill Allombert <ballombe@debian.org> Mon, 06 Jun 2011 19:51:39 +0200
+ -- Bill Allombert <ballombe@debian.org> Wed, 08 Jun 2011 23:01:20 +0200
debian-policy (3.9.2.0) unstable; urgency=low
package must depend upon it explicitly.
</p>
</sect>
+
+ <sect id="perl_upgrades">
+ <heading>Perl Package Upgrades</heading>
+ <p>
+ Starting from <package>perl</package> 5.12.3-2, a dpkg trigger
+ named <var>perl-major-upgrade</var> will be triggered by the
+ postinst of the <package>perl</package> package during major
+ upgrades. Some examples of things which constitute a major upgrade
+ are an upgrade which would change the value of versioned
+ directories in <tt>@INC</tt>, or one which changes <tt>abiname</tt>.
+ Any package may declare an interest in the trigger, especially
+ packages including long-running daemons which would stop working
+ until restart.
+ </p>
+ <p>
+ It is suggested that such packages include an appropriate section
+ in their postinst to handle the trigger by restarting relevant
+ daemons or notifying users of further action.
+ </p>
+ </sect>
</chapt>
<appendix id="perl6">
of normal rules for non-free dependencies and were largely obsolete, so
they have been removed.
</item>
+<tag>perl</tag>
+ <item> Packages may declare an interest in the <var>perl-major-upgrade</var>
+ trigger to be notified of major upgrades of perl.
+ </item>
</taglist></p>
<sect> Version 3.9.2.0