perldelta: known problems

2 files changed, 50 insertions, 1 deletions

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 7498997172..06b4a9d5c0 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -2135,6 +2135,50 @@ not always detected, giving incorrect results.  This is now fixed.
 
 =back
 
+=head1 Known Problems
+
+=over 4
+
+=item *
+
+Some modules have been broken by the L<context stack rework|/Internal Changes>.
+These modules were relying on non-guaranteed implementation details in perl.
+Their maintainers have been informed, and should contact perl5-porters for
+advice if needed.  Below is a subset of these modules:
+
+=over 4
+
+=item L<Algorithm::Permute>
+
+=item L<Coro>
+
+L<Coro> and perl v5.22.0 were already incompatible due to a change in the perl,
+and the reworking on the perl context stack creates a further incompatibility.
+perl5-porters has L<discussed the issue on the mailing
+list|http://www.nntp.perl.org/group/perl.perl5.porters/2016/05/msg236174.html>.
+
+=item L<RPerl>
+
+=item L<Scope::Upper>
+
+=item L<TryCatch>
+
+=back
+
+=item *
+
+The module L<lexical::underscore> no longer works on perl v5.24.0, because perl
+no longer has a lexical C<$_>!
+
+=item *
+
+C<mod_perl> has been patched for compatibility for v5.22.0 and later but no
+release has been made.  The relevant patch (and other changes) can be found in
+their source code repository, L<mirrored at
+GitHub|https://github.com/apache/mod_perl/commit/82827132efd3c2e25cc413c85af61bb63375da6e>.
+
+=back
+
 =head1 Acknowledgements
 
 [ XXX: generate this just in time, Ricardo! ]
diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat
index c0c4107b35..4f1379b262 100644
--- a/t/porting/known_pod_issues.dat
+++ b/t/porting/known_pod_issues.dat
@@ -1,4 +1,4 @@
-# This file is the data file for t/porting/podcheck.t.
+# This file is the data file for porting/podcheck.t.
 # There are three types of lines.
 # Comment lines are white-space only or begin with a '#', like this one.  Any
 #   changes you make to the comment lines will be lost when the file is
@@ -15,6 +15,7 @@ _control87(3)
 accept(2)
 access(2)
 Algorithm::C3
+Algorithm::Permute
 AnyEvent
 Apache::MP3
 Archive::Extract
@@ -141,6 +142,7 @@ IPC::Signal
 kill(3)
 langinfo(3)
 LaTeX::Encode
+lexical::underscore
 Lexical::Var
 Lingua::JA::Romanize::Japanese
 Lingua::KO::Hangul::Util
@@ -234,8 +236,10 @@ recvfrom(2)
 recvmsg(3)
 rename(2)
 Role::Tiny
+RPerl
 s2p
 Scalar::Readonly
+Scope::Upper
 sdbm(3)
 select(2)
 semctl(2)
@@ -285,6 +289,7 @@ Tk
 Tk::Pod
 touch(1)
 tr(1)
+TryCatch
 tty(1)
 umask(2)
 Unicode::CaseFold