[DOC-CVS] [doc-base] master: Automatically generated files must self-declare (#317)

Author: alfsb (alfsb)
Committer: GitHub (web-flow)
Pusher: alfsb
Date: 2026-07-17T15:49:43-03:00

Commit: https://github.com/php/doc-base/commit/4555190558990db31583a997bfa010d1823d1cae
Raw diff: https://github.com/php/doc-base/commit/4555190558990db31583a997bfa010d1823d1cae.diff

Automatically generated files must self-declare (#317)

Changed paths:
  M  scripts/gen-phpdoc-tz-list.php


Diff:

diff --git a/scripts/gen-phpdoc-tz-list.php b/scripts/gen-phpdoc-tz-list.php
index 0b4db8a71e..4fc1bfc27d 100644
--- a/scripts/gen-phpdoc-tz-list.php
+++ b/scripts/gen-phpdoc-tz-list.php
@@ -31,18 +31,22 @@
 	$others = $groupedList['Others'];
 	unset($groupedList['Others']);
 	$groupedList['Others'] = $others;
-?>
-<?php echo '<?'; ?>xml version="1.0" encoding="UTF-8"?>
-<!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND -->
 
-<!-- The script to generate this file is scripts/gen-phpdoc-tz-list.php -->
-<!-- in the doc-base repo. However, it should only need to be run when  -->
-<!-- the tzdb file is updated by the maintainer of DateTime/timelib.    -->
+    echo <<<'XML'
+    <?xml version="1.0" encoding="UTF-8"?>
+    <?do-not-translate?>
+
+    <!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND -->
+    <!-- The script to generate this file is scripts/gen-phpdoc-tz-list.php -->
+    <!-- in the doc-base repo. However, it should only need to be run when  -->
+    <!-- the tzdb file is updated by the maintainer of DateTime/timelib.    -->
+
+    <appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+     &date.timezone.intro.title;
+     &date.timezone.intro;
+
+    XML;
 
-<appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- &date.timezone.intro.title;
- &date.timezone.intro;
-<?php
     if (function_exists('timezone_version_get')) {
 ?>
 
@@ -54,7 +58,7 @@
 <?php
     }
 
-    foreach ($groupedList as $group => $zones) { 
+    foreach ($groupedList as $group => $zones) {
         $groupColumns = $columns;
         $m = count($zones) > ($groupColumns-1) ? $groupColumns : count($zones); ?>
 
@@ -118,4 +122,3 @@
 vim: et tw=78 syn=php
 vi: ts=4 sw=1
 -->
-