[doc-en] master: Fix do-not-translate entity statistics (#5711)

Author: alfsb (alfsb) Committer: GitHub (web-flow) Pusher: alfsb Date: 2026-09-04T09:19:51-03:00 Commit: https://github.com/php/doc-en/commit/a86d05d3ae124630c2b85d7306862296d572f7de Raw diff: https://github.com/php/doc-en/commit/a86d05d3ae124630c2b85d7306862296d572f7de.diff Fix do-not-translate entity statistics (#5711) Changed paths: M entities/entities.php.ent M entities/entities.remove.ent M entities/entities.url.ent Diff: 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>