From 80087987a2f841dabe17ae8e46bac1d3643c6754 Mon Sep 17 00:00:00 2001
From: Olivier Hill <ohill@php.net>
Date: Fri, 19 Dec 2008 15:23:04 +0000
Subject: [PATCH] Documenting new fields available with recent releases

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@271610 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../geoip/functions/geoip-record-by-name.xml  | 57 ++++++++++++++++++-
 1 file changed, 54 insertions(+), 3 deletions(-)

diff --git a/reference/geoip/functions/geoip-record-by-name.xml b/reference/geoip/functions/geoip-record-by-name.xml
index d95762a418..6a73308b59 100644
--- a/reference/geoip/functions/geoip-record-by-name.xml
+++ b/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] =>