php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #35897 add more information about supported timezones
Submitted: 2006-01-04 20:37 UTC Modified: 2006-01-04 23:03 UTC
From: lsmith@php.net Assigned: sean (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: irrelevant
Private report: No CVE-ID: None
View Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
If you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: lsmith@php.net
New email:
PHP Version: OS:

 

 [2006-01-04 20:37 UTC] lsmith@php.net 
Description:
------------
There is currently no information about the supported timezones from the datetime section of the manual. Also from the timezone listing there is no link to the pecl::timezonedb package. So users might be misled to believe they need to upgrade PHP to update their timezones.

The following patches are untested and probably need some tweaking from a phpdoc/docbook expert. 

Reproduce code:
---------------
add link to supported timezones to date_default_timezone_get()
RCS file: /repository/phpdoc/en/reference/datetime/functions/date-default-timezone-get.xml,v
retrieving revision 1.3
diff -u -r1.3 date-default-timezone-get.xml
--- date-default-timezone-get.xml	2 Sep 2005 14:39:56 -0000	1.3
+++ date-default-timezone-get.xml	4 Jan 2006 19:27:59 -0000
@@ -46,6 +46,12 @@
     </listitem>
    </itemizedlist>
   </para>
+  <note>
+   <simpara>
+    The supported timezones can be found here
+    <xref linkend="timezones"/> inside the <xref linkend="appendixes"/>.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="returnvalues">

hopefully add link to pecl::timezonedb and the windows dll to the final output of the timezone overview
RCS file: /repository/phpdoc/scripts/gen-phpdoc-tz-list.php,v
retrieving revision 1.1
diff -u -r1.1 gen-phpdoc-tz-list.php
--- gen-phpdoc-tz-list.php	19 Oct 2005 07:20:48 -0000	1.1
+++ gen-phpdoc-tz-list.php	4 Jan 2006 19:26:40 -0000
@@ -62,6 +62,14 @@
     </tbody>
    </tgroup>
   </table>
+  <note>
+   <simpara>
+    The latest version of the timezone database can be downloaded here:
+    http://pecl.php.net/package/timezonedb
+    For windows users a pre compiled DLL can be downloaded here:
+    http://pecl4win.php.net/ext.php/php_timezonedb.dll
+   </simpara>
+  </note>
  </sect1>
 <?php } ?>
 </appendix>

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2006-01-04 22:56 UTC] lsmith@php.net 
this might be a nicer variant for the script fix .. though it might still need some entity love ..

RCS file: /repository/phpdoc/scripts/gen-phpdoc-tz-list.php,v
retrieving revision 1.1
diff -u -r1.1 gen-phpdoc-tz-list.php
--- gen-phpdoc-tz-list.php	19 Oct 2005 07:20:48 -0000	1.1
+++ gen-phpdoc-tz-list.php	4 Jan 2006 21:54:35 -0000
@@ -62,6 +62,14 @@
     </tbody>
    </tgroup>
   </table>
+  <note>
+   <simpara>
+    The latest version of the timezone database can be downloaded
+    <ulink link="http://pecl.php.net/package/timezonedb">here</ulink>.
+    For windows users a pre compiled DLL can be downloaded
+    <ulink link="http://pecl4win.php.net/ext.php/php_timezonedb.dll">here</ulink>.
+   </simpara>
+  </note>
  </sect1>
 <?php } ?>
 </appendix>
 [2006-01-04 23:03 UTC] sean@php.net 
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

Modified the patches and committed.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Wed Nov 19 12:00:02 2025 UTC