From c585c0c0d479f1303d04115be2cd4dfef285decb Mon Sep 17 00:00:00 2001
From: Niels Dossche <7771979+nielsdos@users.noreply.github.com>
Date: Mon, 3 Jul 2023 21:33:21 +0200
Subject: [PATCH] [ci skip] NEWS and UPGRADING

---
 NEWS      | 2 ++
 UPGRADING | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/NEWS b/NEWS
index 683b0dcec6f..3b16f0f0177 100644
--- a/NEWS
+++ b/NEWS
@@ -16,6 +16,8 @@ PHP                                                                        NEWS
     output). (nielsdos)
   . Implemented DOMDocument::adoptNode(). Previously this always threw a
     "not yet implemented" exception. (nielsdos)
+  . Fixed bug GH-9628 (Implicitly removing nodes from \DOMDocument breaks
+    existing references). (nielsdos)
 
 - Fileinfo:
   . Fix GH-11408 (Unable to build PHP 8.3.0 alpha 1 / fileinfo extension).
diff --git a/UPGRADING b/UPGRADING
index 3e939c8c3c9..b709ccacd51 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -267,6 +267,10 @@ PHP 8.3 UPGRADE NOTES
 9. Other Changes to Extensions
 ========================================
 
+- DOM:
+  . The DOM lifetime mechanism has been reworked such that implicitly removed
+    nodes can still be fetched. Previously this resulted in an exception.
+
 - SQLite3
   . The SQLite3 class now throws \SQLite3Exception (extends \Exception) instead
     of \Exception.