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 #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
View Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: test at web dot de
New email:
PHP Version: OS:

 

 [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

Pull Requests

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:34 UTC] cmb@php.net 
Fixed with <http://svn.php.net/viewvc?view=revision&revision=350546>.
 [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-2024 The PHP Group
All rights reserved. 		Last updated: Sun Dec 22 01:01:30 2024 UTC