From: Michael Ow <mow@svn.icu-project.org>
Date: Tue, 13 Dec 2011 17:44:04 +0000 (+0000)
Subject: ICU-8887 Update timezone doc in ICU4C
X-Git-Tag: milestone-59-0-1~4246
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fc76cb342c4d926a84f988e3a3b51f03964cf9af;p=icu

ICU-8887 Update timezone doc in ICU4C

X-SVN-Rev: 31109
---

diff --git a/icu4c/source/i18n/unicode/timezone.h b/icu4c/source/i18n/unicode/timezone.h
index 0d6e5b7cf61..6873cd47676 100644
--- a/icu4c/source/i18n/unicode/timezone.h
+++ b/icu4c/source/i18n/unicode/timezone.h
@@ -67,7 +67,8 @@ class StringEnumeration;
  * </pre>
  * \htmlonly</blockquote>\endhtmlonly
  * You can use <code>getAvailableIDs</code> method to iterate through
- * all the supported time zone IDs. You can then choose a
+ * all the supported time zone IDs, or getCanonicalID method to check
+ * if a time zone ID is supported or not.  You can then choose a
  * supported ID to get a <code>TimeZone</code>.
  * If the time zone you want is not represented by one of the
  * supported IDs, then you can create a custom time zone ID with
@@ -81,10 +82,12 @@ class StringEnumeration;
  *
  * For example, you might specify GMT+14:00 as a custom
  * time zone ID.  The <code>TimeZone</code> that is returned
- * when you specify a custom time zone ID does not include
- * daylight savings time.  If a custom time zone ID is used,
- * the meaning of what a positive offset is should also be specified.
- * In addition, <code>getCanonicalID</code> can also be used to
+ * when you specify a custom time zone ID uses the specified
+ * offset from GMT(=UTC) and does not observe daylight saving
+ * time. For example, you might specify GMT+14:00 as a custom
+ * time zone ID to create a TimeZone representing 14 hours ahead
+ * of GMT (with no daylight saving time). In addition,
+ * <code>getCanonicalID</code> can also be used to
  * normalize a custom time zone ID.
  *
  * TimeZone is an abstract class representing a time zone.  A TimeZone is needed for