diff --git a/entities/entities.remove.ent b/entities/entities.remove.ent index 0c8bd7976cdc..7b3f14280a78 100644 --- a/entities/entities.remove.ent +++ b/entities/entities.remove.ent @@ -4,19 +4,25 @@ This is a "remove" XML Entity file. See doc-base/scripts/text-entities.php for details. +You can run this script directly. Place here only deprecated or removed entities that are expected NOT be being used in any part of the manual. -If an entity moved here is used in a language in your control, -this means that the entity on the original file is planned to be -removed, or already was removed. - -DO NOT TRANSLATE THIS FILE. +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. On translations, leave an -empty element at the end of file, only updating the revtag. +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 EMPTY. +ON TRANSLATIONS, ONLY UPDATE THE REVTAG. -->