From be9714a4a221a47b10ffcfdd006259bdbca65c28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20L=20F=20S=20Bacci?= <ae@php.net>
Date: Fri, 28 Aug 2026 12:27:20 -0300
Subject: [PATCH] Fix do-not-translate entity statistics

---
 entities/entities.php.ent    |  2 +-
 entities/entities.remove.ent | 43 +++++-------------------------------
 entities/entities.url.ent    |  2 +-
 3 files changed, 8 insertions(+), 39 deletions(-)

diff --git a/entities/entities.php.ent b/entities/entities.php.ent
index de14c7b13589..8736cb6e803d 100644
--- a/entities/entities.php.ent
+++ b/entities/entities.php.ent
@@ -13,7 +13,7 @@ There are a few <filename> tossed near and there.
 -->
 <entities xmlns       = "http://docbook.org/ns/docbook"
           xmlns:xlink = "http://www.w3.org/1999/xlink"
-          translate   = "yes">
+          translate   = "no">
 
 <entity name="array"><type>array</type></entity>
 
diff --git a/entities/entities.remove.ent b/entities/entities.remove.ent
index 7e1cdc617ddf..f2b7d3949933 100644
--- a/entities/entities.remove.ent
+++ b/entities/entities.remove.ent
@@ -1,47 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
+<?do-not-translate?>
 <!--
 
-This is a "remove" XML Entity file.
-See doc-base/scripts/text-entities.php for details.
-You can run this script directly.
-
-# doc-en
+This is a "remove" XML Entity file. See
+  doc-base/scripts/text-entities.php
+for details. You can run that script directly.
 
 Place here only deprecated or removed entities that are
-expected NOT be being used in any part of the manual.
-
-# Translations, question
-
-First, a question. A file like this, that show entities that got
-removed in doc-base/doc-en, AND is tracked by revcheck, helps or
-cause more work than it is worth?
-
-Please, leave your comments in the issue issue:
-  https://github.com/php/doc-en/pull/5711
-
-I (ae) am seriously considering marking this file as do-not-translate,
-so it won't appear in revcheck anymore.
-
-# Translations, instructions
-
-If an entity moved here is used in a translation in your control,
-this means that the entity on the original files is planned to be
-removed, or already was removed, but are temporarily moved here,
-to avoid breaking translations.
-
-This file is tracked by revcheck, so translations have a heads up
-when an entity is removed from doc-en (by revcheck diff links).
-That said, do NOT sync or copy the file CONTENTS in translations,
-otherwise doc-base/scripts/text-entities.php will generate wrong
-statistics, and worse, it will NOT help your translation in
-finding wrong entity usage in your language.
-
-ON TRANSLATIONS, LEAVE <entities/> EMPTY.
-ON TRANSLATIONS, ONLY UPDATE THE REVTAG.
+expected NOT be being used in any part of the manual, but
+are temporarily defined here as to keep translations building.
 
 -->
-
 <entities xmlns       = "http://docbook.org/ns/docbook"
           xmlns:xlink = "http://www.w3.org/1999/xlink"
           translate   = "remove">
diff --git a/entities/entities.url.ent b/entities/entities.url.ent
index c95bd6ad5679..b15248b96451 100644
--- a/entities/entities.url.ent
+++ b/entities/entities.url.ent
@@ -7,7 +7,7 @@ URLs, other addresses and external references.
 -->
 <entities xmlns       = "http://docbook.org/ns/docbook"
           xmlns:xlink = "http://www.w3.org/1999/xlink"
-          translate   = "yes">
+          translate   = "no">
 
 <entity name="book.applied.cryptography">Applied Cryptography by Schneier (ISBN 0-471-11709-9)</entity>
 <entity name="book.programming.classics">Programming Classics: Implementing the World's Best Algorithms by Oliver (ISBN 0-131-00413-1)</entity>