From 3f01b1928898482cdefc76ed08fc1cbceb635947 Mon Sep 17 00:00:00 2001
From: Chris 'BinGOs' Williams <chris@bingosnet.co.uk>
Date: Sun, 27 Jan 2013 21:23:35 +0000
Subject: [PATCH] Document module and utility deprecations in perldelta

---
 pod/perldelta.pod | 150 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 506cb78..d7d1b28 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -53,6 +53,156 @@ an updated module in the L</Modules and Pragmata> section.
 
 [ List each deprecation as a =head2 entry ]
 
+=head2 Deprecated Modules
+
+The following modules will be removed from the core distribution in a
+future release, and should be installed from CPAN instead. Distributions
+on CPAN which require these should add them to their prerequisites. The
+core versions of these modules C<warnings> will issue a deprecation warning.
+
+You can silence these deprecation warnings by installing the modules
+in question from CPAN.
+
+=over
+
+=item L<Archive::Extract>
+
+=item L<B::Lint>
+
+=item L<B::Lint::Debug>
+
+=item L<CPANPLUS>
+
+=item L<CPANPLUS::Backend>
+
+=item L<CPANPLUS::Backend::RV>
+
+=item L<CPANPLUS::Config>
+
+=item L<CPANPLUS::Config::HomeEnv>
+
+=item L<CPANPLUS::Configure>
+
+=item L<CPANPLUS::Configure::Setup>
+
+=item L<CPANPLUS::Dist>
+
+=item L<CPANPLUS::Dist::Autobundle>
+
+=item L<CPANPLUS::Dist::Base>
+
+=item L<CPANPLUS::Dist::Build>
+
+=item L<CPANPLUS::Dist::Build::Constants>
+
+=item L<CPANPLUS::Dist::MM>
+
+=item L<CPANPLUS::Dist::Sample>
+
+=item L<CPANPLUS::Error>
+
+=item L<CPANPLUS::Internals>
+
+=item L<CPANPLUS::Internals::Constants>
+
+=item L<CPANPLUS::Internals::Constants::Report>
+
+=item L<CPANPLUS::Internals::Extract>
+
+=item L<CPANPLUS::Internals::Fetch>
+
+=item L<CPANPLUS::Internals::Report>
+
+=item L<CPANPLUS::Internals::Search>
+
+=item L<CPANPLUS::Internals::Source>
+
+=item L<CPANPLUS::Internals::Source::Memory>
+
+=item L<CPANPLUS::Internals::Source::SQLite>
+
+=item L<CPANPLUS::Internals::Source::SQLite::Tie>
+
+=item L<CPANPLUS::Internals::Utils>
+
+=item L<CPANPLUS::Internals::Utils::Autoflush>
+
+=item L<CPANPLUS::Module>
+
+=item L<CPANPLUS::Module::Author>
+
+=item L<CPANPLUS::Module::Author::Fake>
+
+=item L<CPANPLUS::Module::Checksums>
+
+=item L<CPANPLUS::Module::Fake>
+
+=item L<CPANPLUS::Module::Signature>
+
+=item L<CPANPLUS::Selfupdate>
+
+=item L<CPANPLUS::Shell>
+
+=item L<CPANPLUS::Shell::Classic>
+
+=item L<CPANPLUS::Shell::Default>
+
+=item L<CPANPLUS::Shell::Default::Plugins::CustomSource>
+
+=item L<CPANPLUS::Shell::Default::Plugins::Remote>
+
+=item L<CPANPLUS::Shell::Default::Plugins::Source>
+
+=item L<Devel::InnerPackage>
+
+=item L<Log::Message>
+
+=item L<Log::Message::Config>
+
+=item L<Log::Message::Handlers>
+
+=item L<Log::Message::Item>
+
+=item L<Log::Message::Simple>
+
+=item L<Module::Pluggable>
+
+=item L<Module::Pluggable::Object>
+
+=item L<Object::Accessor>
+
+=item L<Term::UI>
+
+=item L<Term::UI::History>
+
+=back
+
+=head3 Deprecated Utilities
+
+The following utilities will be removed from the core distribution in a
+future release as their associated modules have been deprecated. They
+will remain available with the applicable CPAN distribution.
+
+=over
+
+=item L<cpanp>
+
+Included with L<CPANPLUS>.
+
+=item L<cpanp-run-perl>
+
+Included with L<CPANPLUS>.
+
+=item L<cpan2dist>
+
+Included with L<CPANPLUS>.
+
+=item L<pod2latex>
+
+The L<Pod::LaTeX> module was deprecated with 5.17.8.
+
+=back
+
 =head2 Five additional characters should be escaped in patterns with C</x>
 
 When a regular expression pattern is compiled with C</x>, Perl treats 6
-- 
1.8.3.1