From d7a244ba75f1e8c7a5be8ec229b02190c4c68f58 Mon Sep 17 00:00:00 2001
From: Derick Rethans <derick@php.net>
Date: Sun, 26 Oct 2014 17:46:51 +0000
Subject: [PATCH] The warning at the start of this file "DO NOT MODIFY BY HAND"
 is there for a reason.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@335144 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/datetime/timezones.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/datetime/timezones.xml b/reference/datetime/timezones.xml
index 66e0650e72..aa6bba5808 100644
--- a/reference/datetime/timezones.xml
+++ b/reference/datetime/timezones.xml
@@ -984,6 +984,26 @@
   <warning>
    &date.timezone.bc;
   </warning>
+  <warning>
+   <simpara>
+    If you disregard the above warning, please also note that the IANA
+    timezone database that provides PHP's timezone support uses POSIX style
+    signs, which results in the <literal>Etc/GMT+n</literal> and
+    <literal>Etc/GMT-n</literal> time zones being reversed from common usage.
+   </simpara>
+   <simpara>
+    For example, the time zone 8 hours ahead of GMT that is used in China and
+    Western Australia (among other places) is actually
+    <literal>Etc/GMT-8</literal> in this database, not
+    <literal>Etc/GMT+8</literal> as you would normally expect.
+   </simpara>
+   <simpara>
+    Once again, it is strongly recommended that you use the correct time zone
+    for your location, such as <literal>Asia/Shanghai</literal> or
+    <literal>Australia/Perth</literal> for the above examples.
+   </simpara>
+  </warning>
+
  </sect1>
 </appendix>