From 2a860a6143219a29f739fb992d7f3c3281b36218 Mon Sep 17 00:00:00 2001
From: Petr Viktorin <encukou@gmail.com>
Date: Wed, 17 Apr 2024 15:58:53 +0200
Subject: [PATCH] PEP 387: Add a changelog and a missing Post-History entry
 (#3714)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Victor Stinner <vstinner@python.org>
---
 peps/pep-0387.rst | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/peps/pep-0387.rst b/peps/pep-0387.rst
index 068684b5d..dec4868ed 100644
--- a/peps/pep-0387.rst
+++ b/peps/pep-0387.rst
@@ -1,15 +1,13 @@
 PEP: 387
 Title: Backwards Compatibility Policy
-Version: $Revision$
-Last-Modified: $Date$
 Author: Benjamin Peterson <benjamin@python.org>
 PEP-Delegate: Brett Cannon <brett@python.org>
 Status: Active
 Type: Process
-Content-Type: text/x-rst
 Created: 18-Jun-2009
 Post-History: `19-Jun-2009 <https://mail.python.org/archives/list/python-dev@python.org/thread/YAZQHFUCYEYIX5MIG6LFJLCVQ5ORVUM6/>`__,
               `12-Jun-2020 <https://discuss.python.org/t/pep-387-backwards-compatibilty-policy/4421>`__,
+              `19-Dec-2022 <https://discuss.python.org/t/22042>`__,
               `16-Jun-2023 <https://discuss.python.org/t/formalize-the-concept-of-soft-deprecation-dont-schedule-removal-in-pep-387-backwards-compatibility-policy/27957>`__
 
 
@@ -196,6 +194,21 @@ several releases:
    council.
 
 
+Changelog
+=========
+
+* 2023-Nov-14: Added ``@deprecated`` decorator per :pep:`702`.
+* 2023-Jul-03: Added the Soft Deprecation section, as discussed in
+  `<https://discuss.python.org/t/27957>`__.
+* 2023-Jun-26: Multiple smaller updates and clarifications, discussed in
+  `<https://discuss.python.org/t/22042>`__.
+* 2022-Apr-04: Added explicit notes to ask the Steering Council
+  in several exceptional cases.
+* 2021-Apr-16: Clarified how long a warning must be emitted before
+  a change can be made.
+* 2020-Jul-20: Initial accepted version.
+
+
 References
 ==========
 
@@ -212,14 +225,3 @@ Copyright
 =========
 
 This document has been placed in the public domain.
-
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   coding: utf-8
-   End: