Document what the fields in the output of DateTimeZone::getLocation() mean

php/doc-en@c904155

Author: mumumu

reference/datetime/datetimezone/getlocation.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c90415586ef8e226765667808874b6fd9c33ef09 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="datetimezone.getlocation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -51,7 +51,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$tz = new DateTimeZone("Europe/Prague");
+$tz = new DateTimeZone("Asia/Jakarta");
 print_r($tz->getLocation());
 print_r(timezone_location_get($tz));
 ?>
@@ -62,22 +62,31 @@ print_r(timezone_location_get($tz));
 <![CDATA[
 Array
 (
-    [country_code] => CZ
-    [latitude] => 50.08333
-    [longitude] => 14.43333
-    [comments] => 
+    [country_code] => ID
+    [latitude] => -6.16667
+    [longitude] => 106.8
+    [comments] => Java, Sumatra
 )
 Array
 (
-    [country_code] => CZ
-    [latitude] => 50.08333
-    [longitude] => 14.43333
-    [comments] => 
+    [country_code] => ID
+    [latitude] => -6.16667
+    [longitude] => 106.8
+    [comments] => Java, Sumatra
 )
 ]]>
     </screen>
    </example>
   </para>
+  <para>
+   <literal>country_code</literal> 要素には、ISO 3166-1 alpha-2
+   で定められた国コードがそれぞれ入っています。
+   <literal>latitude</literal> と <literal>longitude</literal>
+   要素には、タイムゾーンの識別子に含まれる都市の座標が入ります。
+   <literal>comments</literal> 要素には (&false; でない場合)、
+   指定された国でこのタイムゾーンが適用される場所のヒントが入ります。
+   この情報はエンドユーザー向けの表現に適しています。
+  </para>
  </refsect1>
 
  <refsect1 role="seealso">