Documenting new fields available with recent releases

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@271610 c90b9560-bf6c-de11-be94-00142212c4b1

reference/geoip/functions/geoip-record-by-name.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry xml:id="function.geoip-record-by-name" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>geoip_record_by_name</refname>
@@ -26,12 +26,30 @@
   </para>
   <para>
    <itemizedlist>
+    <listitem>
+     <simpara>
+      "continent_code" -- Two letter continent code (as of version 1.0.4 with 
+      libgeoip 1.4.3 or newer)
+     </simpara>
+    </listitem>
     <listitem>
      <simpara>
       "country_code" -- Two letter country code (see
       <function>geoip_country_code_by_name</function>)
      </simpara>
     </listitem>
+    <listitem>
+     <simpara>
+      "country_code3" -- Three letter country code (see
+      <function>geoip_country_code3_by_name</function>)
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      "country_name" -- The country name (see
+      <function>geoip_country_name_by_name</function>)
+     </simpara>
+    </listitem>
     <listitem>
      <simpara>
       "region" -- The region code (ex: CA for California)
@@ -59,7 +77,7 @@
     </listitem>
     <listitem>
      <simpara>
-      "dma_code"
+      "dma_code" -- Designated Market Area code (USA and Canada only)
      </simpara>
     </listitem>
     <listitem>
@@ -69,8 +87,8 @@
     </listitem>
    </itemizedlist>
   </para>
-
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -94,6 +112,36 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>1.0.4</entry>
+       <entry>
+        Adding the continent_code with GeoIP Library 1.4.3 or newer only
+       </entry>
+      </row>
+      <row>
+       <entry>1.0.3</entry>
+       <entry>
+        Adding country_code3 and country_name
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -117,7 +165,10 @@ if ($record) {
 <![CDATA[
 Array
 (
+    [continent_code] => NA
     [country_code] => US
+    [country_code3] => USA
+    [country_name] => United States
     [region] => CA
     [city] => Marina Del Rey
     [postal_code] =>