cvs: phpdoc /en language-snippets.ent /en/reference/datetime timezones.xml /scripts gen-phpdoc-tz-list.php
| From: | Hannes Magnusson | Date: | Sat, 26 Apr 2008 17:18:03 +0000 |
| Subject: | cvs: phpdoc /en language-snippets.ent /en/reference/datetime timezones.xml /scripts gen-phpdoc-tz-list.php | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-1567@lists.php.net to get a copy of this message | ||
bjori Sat Apr 26 17:18:03 2008 UTC
Modified files:
/phpdoc/en language-snippets.ent
/phpdoc/scripts gen-phpdoc-tz-list.php
/phpdoc/en/reference/datetime timezones.xml
Log:
- Move hardcoded text in the timezone appendix into entities
- Move the first timezone category into its own page
http://cvs.php.net/viewvc.cgi/phpdoc/en/language-snippets.ent?r1=1.220&r2=1.221&diff_format=u Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.220 phpdoc/en/language-snippets.ent:1.221 --- phpdoc/en/language-snippets.ent:1.220 Mon Apr 14 17:28:03 2008 +++ phpdoc/en/language-snippets.ent Sat Apr 26 17:18:02 2008 @@ -1,4 +1,4 @@ -<!-- $Revision: 1.220 $ --> +<!-- $Revision: 1.221 $ --> <!-- Keep 'em sorted --> @@ -308,6 +308,22 @@ <function>m_initengine</function>.</para></listitem></varlistentry>'> <!-- Date and time entities --> +<!ENTITY date.timezone.intro.title '<title>List of Supported Timezones</title>'> + +<!ENTITY date.timezone.intro "<para> +Here you'll find the complete list of timezones supported by PHP, which are +meant to be used with e.g. <function>date_default_timezone_set</function>. +</para><note><simpara>The latest version of the timezone database can be +installed via PECL's <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>. +For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win +site: <link xlink:href='&url.pecl.timezonedb.dll;' xmlns:xlink='http://www.w3.org/1999/xlink'>php_timezonedb.dll</link>. +</simpara></note>"> + +<!ENTITY date.timezone.bc '<simpara>Please do not use any of the timezones +listed here (besides UTC), they only exist for backward compatible reasons. +</simpara>'> + + <!ENTITY date.timezone.errors.description '<para> Every call to a date/time function will generate a <constant>E_NOTICE</constant> if the time zone is not valid, and/or a <constant>E_STRICT</constant> message @@ -910,3 +926,4 @@ method requires the &php.ini; setting <literal>phar.readonly</literal> to be set to <literal>0</literal> in order to work for <classname>Phar</classname> objects. Otherwise, a <classname>PharException</classname> will be thrown.</para></note>'> + http://cvs.php.net/viewvc.cgi/phpdoc/scripts/gen-phpdoc-tz-list.php?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/scripts/gen-phpdoc-tz-list.php diff -u phpdoc/scripts/gen-phpdoc-tz-list.php:1.11 phpdoc/scripts/gen-phpdoc-tz-list.php:1.12 --- phpdoc/scripts/gen-phpdoc-tz-list.php:1.11 Tue Apr 1 13:16:13 2008 +++ phpdoc/scripts/gen-phpdoc-tz-list.php Sat Apr 26 17:18:02 2008 @@ -27,29 +27,20 @@ $groupedList['Others'] = $others; ?> <?php echo '<?'; ?>xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- AUTO GENERATED, DO NOT MODIFY BY HAND --> +<!-- $Revision: 1.12 $ --> +<!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND --> <appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>List of Supported Timezones</title> - <para> - Here you'll find the complete list of timezones supported by PHP, which are - meant to be used with e.g. <function>date_default_timezone_set</function>. - </para> - <note> - <simpara> - The latest version of the timezone database can be installed via PECL's - <link xlink:href="&url.pecl.package.get;timezonedb">timezonedb</link>. - For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win - site: <link xlink:href="&url.pecl.timezonedb.dll;">php_timezonedb.dll</link>. - </simpara> - </note> + &date.timezone.intro.title; + <sect1 xml:id="timezones.intro"> + &date.timezone.intro; + </sect1> <?php foreach ($groupedList as $group => $zones) { $m = count($zones) > 4 ? 5 : count($zones); ?> <sect1 xml:id="timezones.<?php echo strtolower($group); ?>"> - <title>List of timezones in the group <?php echo $group; ?></title> + <title><?php echo $group; ?></title> <table> <title><?php echo $group; ?></title> <tgroup cols="<?php echo $m; ?>"> @@ -78,10 +69,7 @@ </table> <?php if ( $group == 'Others' ) { ?> <warning> - <simpara> - Please do not use any of the timezones listed here (besides UTC), they - only exist for backward compatible reasons. - </simpara> + &date.timezone.bc; </warning> <?php } ?> </sect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/timezones.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/datetime/timezones.xml diff -u phpdoc/en/reference/datetime/timezones.xml:1.1 phpdoc/en/reference/datetime/timezones.xml:1.2 --- phpdoc/en/reference/datetime/timezones.xml:1.1 Sun Apr 20 15:41:21 2008 +++ phpdoc/en/reference/datetime/timezones.xml Sat Apr 26 17:18:03 2008 @@ -1,24 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- AUTO GENERATED, DO NOT MODIFY BY HAND --> +<!-- $Revision: 1.2 $ --> +<!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND --> <appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>List of Supported Timezones</title> - <para> - Here you'll find the complete list of timezones supported by PHP, which are - meant to be used with e.g. <function>date_default_timezone_set</function>. - </para> - <note> - <simpara> - The latest version of the timezone database can be installed via PECL's - <link xlink:href="&url.pecl.package.get;timezonedb">timezonedb</link>. - For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win - site: <link xlink:href="&url.pecl.timezonedb.dll;">php_timezonedb.dll</link>. - </simpara> - </note> + &date.timezone.intro.title; + <sect1 xml:id="timezones.intro"> + &date.timezone.intro; + </sect1> <sect1 xml:id="timezones.africa"> - <title>List of timezones in the group Africa</title> + <title>Africa</title> <table> <title>Africa</title> <tgroup cols="5"> @@ -106,7 +97,7 @@ </sect1> <sect1 xml:id="timezones.america"> - <title>List of timezones in the group America</title> + <title>America</title> <table> <title>America</title> <tgroup cols="5"> @@ -334,7 +325,7 @@ </sect1> <sect1 xml:id="timezones.antarctica"> - <title>List of timezones in the group Antarctica</title> + <title>Antarctica</title> <table> <title>Antarctica</title> <tgroup cols="5"> @@ -359,7 +350,7 @@ </sect1> <sect1 xml:id="timezones.arctic"> - <title>List of timezones in the group Arctic</title> + <title>Arctic</title> <table> <title>Arctic</title> <tgroup cols="1"> @@ -373,7 +364,7 @@ </sect1> <sect1 xml:id="timezones.asia"> - <title>List of timezones in the group Asia</title> + <title>Asia</title> <table> <title>Asia</title> <tgroup cols="5"> @@ -510,7 +501,7 @@ </sect1> <sect1 xml:id="timezones.atlantic"> - <title>List of timezones in the group Atlantic</title> + <title>Atlantic</title> <table> <title>Atlantic</title> <tgroup cols="5"> @@ -542,7 +533,7 @@ </sect1> <sect1 xml:id="timezones.australia"> - <title>List of timezones in the group Australia</title> + <title>Australia</title> <table> <title>Australia</title> <tgroup cols="5"> @@ -588,7 +579,7 @@ </sect1> <sect1 xml:id="timezones.europe"> - <title>List of timezones in the group Europe</title> + <title>Europe</title> <table> <title>Europe</title> <tgroup cols="5"> @@ -683,7 +674,7 @@ </sect1> <sect1 xml:id="timezones.indian"> - <title>List of timezones in the group Indian</title> + <title>Indian</title> <table> <title>Indian</title> <tgroup cols="5"> @@ -715,7 +706,7 @@ </sect1> <sect1 xml:id="timezones.pacific"> - <title>List of timezones in the group Pacific</title> + <title>Pacific</title> <table> <title>Pacific</title> <tgroup cols="5"> @@ -782,7 +773,7 @@ </sect1> <sect1 xml:id="timezones.others"> - <title>List of timezones in the group Others</title> + <title>Others</title> <table> <title>Others</title> <tgroup cols="5"> @@ -952,10 +943,7 @@ </tgroup> </table> <warning> - <simpara> - Please do not use any of the timezones listed here (besides UTC), they - only exist for backward compatible reasons. - </simpara> + &date.timezone.bc; </warning> </sect1> </appendix>
http://cvs.php.net/viewvc.cgi/phpdoc/en/language-snippets.ent?r1=1.220&r2=1.221&diff_format=u Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.220 phpdoc/en/language-snippets.ent:1.221 --- phpdoc/en/language-snippets.ent:1.220 Mon Apr 14 17:28:03 2008 +++ phpdoc/en/language-snippets.ent Sat Apr 26 17:18:02 2008 @@ -1,4 +1,4 @@ -<!-- $Revision: 1.220 $ --> +<!-- $Revision: 1.221 $ --> <!-- Keep 'em sorted --> @@ -308,6 +308,22 @@ <function>m_initengine</function>.</para></listitem></varlistentry>'> <!-- Date and time entities --> +<!ENTITY date.timezone.intro.title '<title>List of Supported Timezones</title>'> + +<!ENTITY date.timezone.intro "<para> +Here you'll find the complete list of timezones supported by PHP, which are +meant to be used with e.g. <function>date_default_timezone_set</function>. +</para><note><simpara>The latest version of the timezone database can be +installed via PECL's <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>. +For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win +site: <link xlink:href='&url.pecl.timezonedb.dll;' xmlns:xlink='http://www.w3.org/1999/xlink'>php_timezonedb.dll</link>. +</simpara></note>"> + +<!ENTITY date.timezone.bc '<simpara>Please do not use any of the timezones +listed here (besides UTC), they only exist for backward compatible reasons. +</simpara>'> + + <!ENTITY date.timezone.errors.description '<para> Every call to a date/time function will generate a <constant>E_NOTICE</constant> if the time zone is not valid, and/or a <constant>E_STRICT</constant> message @@ -910,3 +926,4 @@ method requires the &php.ini; setting <literal>phar.readonly</literal> to be set to <literal>0</literal> in order to work for <classname>Phar</classname> objects. Otherwise, a <classname>PharException</classname> will be thrown.</para></note>'> + http://cvs.php.net/viewvc.cgi/phpdoc/scripts/gen-phpdoc-tz-list.php?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/scripts/gen-phpdoc-tz-list.php diff -u phpdoc/scripts/gen-phpdoc-tz-list.php:1.11 phpdoc/scripts/gen-phpdoc-tz-list.php:1.12 --- phpdoc/scripts/gen-phpdoc-tz-list.php:1.11 Tue Apr 1 13:16:13 2008 +++ phpdoc/scripts/gen-phpdoc-tz-list.php Sat Apr 26 17:18:02 2008 @@ -27,29 +27,20 @@ $groupedList['Others'] = $others; ?> <?php echo '<?'; ?>xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- AUTO GENERATED, DO NOT MODIFY BY HAND --> +<!-- $Revision: 1.12 $ --> +<!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND --> <appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>List of Supported Timezones</title> - <para> - Here you'll find the complete list of timezones supported by PHP, which are - meant to be used with e.g. <function>date_default_timezone_set</function>. - </para> - <note> - <simpara> - The latest version of the timezone database can be installed via PECL's - <link xlink:href="&url.pecl.package.get;timezonedb">timezonedb</link>. - For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win - site: <link xlink:href="&url.pecl.timezonedb.dll;">php_timezonedb.dll</link>. - </simpara> - </note> + &date.timezone.intro.title; + <sect1 xml:id="timezones.intro"> + &date.timezone.intro; + </sect1> <?php foreach ($groupedList as $group => $zones) { $m = count($zones) > 4 ? 5 : count($zones); ?> <sect1 xml:id="timezones.<?php echo strtolower($group); ?>"> - <title>List of timezones in the group <?php echo $group; ?></title> + <title><?php echo $group; ?></title> <table> <title><?php echo $group; ?></title> <tgroup cols="<?php echo $m; ?>"> @@ -78,10 +69,7 @@ </table> <?php if ( $group == 'Others' ) { ?> <warning> - <simpara> - Please do not use any of the timezones listed here (besides UTC), they - only exist for backward compatible reasons. - </simpara> + &date.timezone.bc; </warning> <?php } ?> </sect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/timezones.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/datetime/timezones.xml diff -u phpdoc/en/reference/datetime/timezones.xml:1.1 phpdoc/en/reference/datetime/timezones.xml:1.2 --- phpdoc/en/reference/datetime/timezones.xml:1.1 Sun Apr 20 15:41:21 2008 +++ phpdoc/en/reference/datetime/timezones.xml Sat Apr 26 17:18:03 2008 @@ -1,24 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- AUTO GENERATED, DO NOT MODIFY BY HAND --> +<!-- $Revision: 1.2 $ --> +<!-- AUTO GENERATED, DO NOT TRANSLATE OR MODIFY BY HAND --> <appendix xml:id="timezones" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>List of Supported Timezones</title> - <para> - Here you'll find the complete list of timezones supported by PHP, which are - meant to be used with e.g. <function>date_default_timezone_set</function>. - </para> - <note> - <simpara> - The latest version of the timezone database can be installed via PECL's - <link xlink:href="&url.pecl.package.get;timezonedb">timezonedb</link>. - For Windows users, a pre-compiled DLL can be downloaded from the PECL4Win - site: <link xlink:href="&url.pecl.timezonedb.dll;">php_timezonedb.dll</link>. - </simpara> - </note> + &date.timezone.intro.title; + <sect1 xml:id="timezones.intro"> + &date.timezone.intro; + </sect1> <sect1 xml:id="timezones.africa"> - <title>List of timezones in the group Africa</title> + <title>Africa</title> <table> <title>Africa</title> <tgroup cols="5"> @@ -106,7 +97,7 @@ </sect1> <sect1 xml:id="timezones.america"> - <title>List of timezones in the group America</title> + <title>America</title> <table> <title>America</title> <tgroup cols="5"> @@ -334,7 +325,7 @@ </sect1> <sect1 xml:id="timezones.antarctica"> - <title>List of timezones in the group Antarctica</title> + <title>Antarctica</title> <table> <title>Antarctica</title> <tgroup cols="5"> @@ -359,7 +350,7 @@ </sect1> <sect1 xml:id="timezones.arctic"> - <title>List of timezones in the group Arctic</title> + <title>Arctic</title> <table> <title>Arctic</title> <tgroup cols="1"> @@ -373,7 +364,7 @@ </sect1> <sect1 xml:id="timezones.asia"> - <title>List of timezones in the group Asia</title> + <title>Asia</title> <table> <title>Asia</title> <tgroup cols="5"> @@ -510,7 +501,7 @@ </sect1> <sect1 xml:id="timezones.atlantic"> - <title>List of timezones in the group Atlantic</title> + <title>Atlantic</title> <table> <title>Atlantic</title> <tgroup cols="5"> @@ -542,7 +533,7 @@ </sect1> <sect1 xml:id="timezones.australia"> - <title>List of timezones in the group Australia</title> + <title>Australia</title> <table> <title>Australia</title> <tgroup cols="5"> @@ -588,7 +579,7 @@ </sect1> <sect1 xml:id="timezones.europe"> - <title>List of timezones in the group Europe</title> + <title>Europe</title> <table> <title>Europe</title> <tgroup cols="5"> @@ -683,7 +674,7 @@ </sect1> <sect1 xml:id="timezones.indian"> - <title>List of timezones in the group Indian</title> + <title>Indian</title> <table> <title>Indian</title> <tgroup cols="5"> @@ -715,7 +706,7 @@ </sect1> <sect1 xml:id="timezones.pacific"> - <title>List of timezones in the group Pacific</title> + <title>Pacific</title> <table> <title>Pacific</title> <tgroup cols="5"> @@ -782,7 +773,7 @@ </sect1> <sect1 xml:id="timezones.others"> - <title>List of timezones in the group Others</title> + <title>Others</title> <table> <title>Others</title> <tgroup cols="5"> @@ -952,10 +943,7 @@ </tgroup> </table> <warning> - <simpara> - Please do not use any of the timezones listed here (besides UTC), they - only exist for backward compatible reasons. - </simpara> + &date.timezone.bc; </warning> </sect1> </appendix>