geoip: extend docs after discussion with Francesco Castellano
authorHenning Westerholt <henning.westerholt@1und1.de>
Mon, 16 May 2011 13:48:53 +0000 (15:48 +0200)
committerHenning Westerholt <henning.westerholt@1und1.de>
Mon, 16 May 2011 13:48:53 +0000 (15:48 +0200)
modules/geoip/README
modules/geoip/doc/geoip_admin.xml

index 016d0d8..595b5df 100644 (file)
@@ -82,6 +82,14 @@ Chapter 1. Admin Guide
    and its derivatives as libgeoip, and probably by other distributions as
    well.
 
+   Debian Linux squeeze includes already a database as dependency, but as
+   this contain the wrong data, it will not work correctly with the
+   module. More acurate, the module expect the GeoIP City Edition, and
+   will not work with the GeoIP Country Edition. In newer Debian Linux
+   releases the package geoip-database-contrib should contain the
+   necessary database. You can download the Lite edition of the DB from
+   here.
+
    This module exports a new class of pseudo-variables - $gip(pvc=>key) -
    to enable access to the results of a query to the database.
 
index b8c9f17..f1df9ca 100644 (file)
@@ -28,7 +28,7 @@
        </para>
        <para>
                This database itself can be obtained on a free or commercial basis 
-               <ulink url="http://www.maxmind.com/app/ip-location">here</ulink>.  The 
+               <ulink url="http://www.maxmind.com/app/ip-location">here</ulink>. The 
                library that interfaces with the Max Mind API, as well as scripts to
                automate downloading of the on-disk version of the open-source 
                database is also packaged by the Debian Linux distribution and 
                other distributions as well.
        </para>
        <para>
+               Debian Linux squeeze includes already a database as dependency, but as
+               this contain the wrong data, it will not work correctly with the module.
+               More acurate, the module expect the <emphasis>GeoIP City Edition</emphasis>,
+               and will not work with the <emphasis>GeoIP Country Edition</emphasis>. In
+               newer Debian Linux releases the package <emphasis>geoip-database-contrib</emphasis>
+               should contain the necessary database. You can download the Lite edition
+               of the DB from <ulink url="http://www.maxmind.com/app/geolitecity">here</ulink>.
+       </para>
+       <para>
                This module exports a new class of pseudo-variables -
                $gip(pvc=&gt;key) - to enable access to the results of a query to the
                database.