From 6a578ab2feebd75e9c8c620256b64fb4c3655cce Mon Sep 17 00:00:00 2001
From: "Paul \"LeoNerd\" Evans" <leonerd@leonerd.org.uk>
Date: Fri, 16 Feb 2024 15:16:29 +0000
Subject: [PATCH] Add deprecation to pod/perldeprecation.pod

---
 pod/perldeprecation.pod | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/pod/perldeprecation.pod b/pod/perldeprecation.pod
index f85789937340b..f180ef9523377 100644
--- a/pod/perldeprecation.pod
+++ b/pod/perldeprecation.pod
@@ -60,6 +60,16 @@ in deprecation warnings.
 
 Category: "deprecated::unicode_property_name"
 
+=head2 Perl 5.46
+
+=head3 C<use VERSION> while another C<use VERSION> is in scope
+
+A C<use VERSION> declaration has many implicit effects on the surrounding
+scope, such as L<strict> and L<feature> flags, or importing L<builtin>
+functions. Once you have a C<use VERSION> statement in scope, any other
+C<use VERSION> statement is now deprecated since Perl 5.39.8, due to the
+increasing complexity of swapping from one prevalent version to another.
+
 =head2 Perl 5.44
 
 =head3 Calling a missing C<import()> or C<unimport()> method with an argument