php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #80082 [DE] Misleading documentation and API behaviour
Submitted: 2020-09-09 14:44 UTC Modified: 2020-09-11 12:34 UTC
From: test at web dot de Assigned: cmb (profile)
Status: Closed Package: Translation problem
PHP Version: 7.3.22 OS: Windows
Private report: No CVE-ID: None
 [2020-09-09 14:44 UTC] test at web dot de
Description:
------------
---
From manual page: https://php.net/timezones.others
---

Sorry for interrupting..
I just want to point out to you, that what you have on the timezones-page is a GIANT mess from my point of view!

You make all those standard ('other') timezones available, and I thank you for doing so. BUT you have a GIANT warning at top of the page, basically saying "don't touch!" - without giving a proper reason for not touching it (backwards compatibility.. but I WANT to use THOSE ones and not those summer-/wintertime dependent ones you provide for example via https://www.php.net/manual/de/timezones.php
I don't see any reason, why I should not use them, and why I should switch to summer-/wintertime-based ones.

I hope you just -remove the warnings- and decide to KEEP the 'other' timezones, because people might acutally HAVE TO use them.


SECOND: concerning the second warning on the page
GMT+x => GMT-x 
please fix this..


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2020-09-09 14:49 UTC] cmb@php.net
-Summary: Misleading documentation and API behaviour +Summary: [DE] Misleading documentation and API behaviour -Type: Bug +Type: Documentation Problem -Package: *General Issues +Package: Translation problem -Assigned To: +Assigned To: cmb
 [2020-09-09 14:49 UTC] cmb@php.net
Ah, that appears to be mostly a translation issue; the English
page says:

| Please do not use any of the timezones listed here (besides
| UTC), they only exist for backward compatible reasons, and may
| expose erroneous behavior.

The last clause is missing from the German documentation.

> GMT+x => GMT-x 
> please fix this..

Fix what?
 [2020-09-11 12:34 UTC] cmb@php.net
-Status: Assigned +Status: Closed
 [2020-09-11 12:35 UTC] phpdocbot@php.net
Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/de.git;a=commit;h=84fd1b7db3058432b4a8d6e2bd275a27c6aab99c
Log: Fix bug #80082: [DE] Misleading documentation and API behaviour
 [2020-12-30 11:15 UTC] nikic@php.net
Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/de.git;a=commit;h=4428724229e32656ef040d1e921130eee9b65a67
Log: Fix bug #80082: [DE] Misleading documentation and API behaviour
 
PHP Copyright © 2001-2021 The PHP Group
All rights reserved.
Last updated: Wed Apr 21 21:01:24 2021 UTC