Package: release-notes
Severity: normal
Tags: patch
Hi,
Attached is a patch to en/issues.dbk which adds a section about possible
problems in third party software caused by the Perl upgrade under "5. Issues to
be aware for stretch" → "5.3. Package specific issues".
Thanks for considering,
dam
-- System Information:
Debian Release: 9.0
APT prefers unstable
APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.0-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=bg_BG.UTF-8, LC_CTYPE=bg_BG.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
Index: issues.dbk
===================================================================
--- issues.dbk (revision 11417)
+++ issues.dbk (working copy)
@@ -579,6 +579,46 @@
</para>
</section>
+ <section id="perl">
+ <title>Perl changes that may break third-party software</title>
+ <note>
+ <para>
+ This section applies to code maintained outside &debian; &release; -
+ local, third-party or legacy Perl scripts and modules.
+ </para>
+ </note>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Some modules have been removed from Perl core and are now shipped
+ in separate packages. Notable examples are <literal>CGI</literal>,
+ available in the <systemitem
+ role="package">libcgi-pm-perl</systemitem> package, and
+ <literal>Module::Build</literal>, available in the <systemitem
+ role="package">libmodule-build-perl</systemitem> package.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The current working directory (<literal>.</literal>) has been removed
+ from the default list of include directories,
+ <literal>@INC</literal>. This may affect usage of
+ <literal>require()</literal>, <literal>do()</literal> etc., where the
+ arguments are files in the current directory.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The full list of changes in Perl since the version in &debian;
+ &oldrelease; is available in <ulink
+
url="https://metacpan.org/pod/release/RJBS/perl-5.22.0/pod/perldelta.pod";>perl522delta</ulink>
+ and <ulink
+
url="https://metacpan.org/pod/release/RJBS/perl-5.24.0/pod/perldelta.pod";>perl524delta</ulink>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
</section>
</chapter>
