document enhancements in address_standardizer

git-svn-id: http://svn.osgeo.org/postgis/trunk@13726 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/NEWS b/NEWS
index 3581b0bfe080f87a5e1f54991e68b2fbb2a6e327..fdf642a48c6df92a96e1de9e26b867611db32848 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,5 @@
 PostGIS 2.2.0
-2014/MM/DD
+2015/09/DD
 
  * Important / Breaking Changes *
 
@@ -70,7 +70,10 @@ PostGIS 2.2.0
   - Added GUC postgis.enable_outdb_rasters to enable access to
     rasters with out-db bands
   - #2387, address_standardizer extension as part of PostGIS
-           Stephen Woodbridge (imaptools.com), Walter Sinclair
+           Stephen Woodbridge (imaptools.com), Walter Sinclair, Regina Obe
+  - #2816, address_standardizer_data_us extension 
+           provides reference lex,gaz,rules for address_standardizer
+           Stephen Woodbridge (imaptools.com), Walter Sinclair, Regina Obe
   - #2341, New mask parameter for ST_MapAlgebra
   - #2397, read encoding info automatically in shapefile loader
   - #2430, ST_ForceCurve

diff --git a/doc/extras_address_standardizer.xml b/doc/extras_address_standardizer.xml
index aad3389f5282320e3cef76470f4a691b3d06f23b..0d010cfdae86c6dff439af2ffbcbcab1bad9cf8d 100644 (file)
--- a/doc/extras_address_standardizer.xml
+++ b/doc/extras_address_standardizer.xml
@@ -140,6 +140,7 @@ into includes in the future for easier maintenance.</para></listitem>
             <abstract>
                 <para>This section lists the PostgreSQL table formats used by the address_standardizer for normalizing addresses.  Note that these tables do not need to be named the same as what is referenced here.  You can have different lex, gaz, rules tables for each country for example or for your custom geocoder.  The names of these tables get passed into the address standardizer functions.  
                 </para>        
+                <para>The packaged extension <varname>address_standardizer_data_us</varname> contains data for standrdizing US addresses.</para>
             </abstract>
         </sect1info>
         <title>Address Standardizer Tables</title>
@@ -575,15 +576,15 @@ SELECT house_num, name, suftype, city, country, state, unit  FROM standardize_ad
                        <screen>house_num |    name    | suftype |  city  | country |     state     |      unit
 ----------+------------+---------+--------+---------+---------------+-----------------
 1         | DEVONSHIRE | PLACE   | BOSTON | USA     | MASSACHUSETTS | # PENTHOUSE 301</screen>
-                       <para>Using tables packaged with tiger geocoder. This example only works if you installec postgis_tiger_geocoder.</para>
-                       <programlisting>SELECT *  FROM standardize_address('tiger.pagc_lex', 
-                          'tiger.pagc_gaz', 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234');</programlisting>
-                          
-                       <para>Make easier to read we'll dump output using hstore extension CREATE EXTENSION hstore; you need to install</para>
-                       <programlisting>SELECT (each(hstore(p))).*  
+      <para>Using tables packaged with tiger geocoder. This example only works if you installec postgis_tiger_geocoder.</para>
+      <programlisting>SELECT *  FROM standardize_address('tiger.pagc_lex', 
+         'tiger.pagc_gaz', 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234');</programlisting>
+         
+      <para>Make easier to read we'll dump output using hstore extension CREATE EXTENSION hstore; you need to install</para>
+      <programlisting>SELECT (each(hstore(p))).*  
  FROM standardize_address('tiger.pagc_lex', 'tiger.pagc_gaz', 
    'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA 02109-1234') As p;</programlisting>
-                       <screen>    key     |      value
+       <screen>    key     |      value
 ------------+-----------------
  box        |
  city       | BOSTON
@@ -601,7 +602,7 @@ SELECT house_num, name, suftype, city, country, state, unit  FROM standardize_ad
  postcode   | 02109
  house_num  | 1
  ruralroute |
-(16 rows)                      
+(16 rows)       
                        </screen>
                </refsection>
        

diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
index 6902a03e1a12d7a50b0fb8c9ac8b1663165b09c1..8506a17d56bb9a82d91dc6d1fafbe6230b42942d 100644 (file)
--- a/doc/xsl/postgis_aggs_mm.xml.xsl
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -458,7 +458,7 @@
        
                                <note><para>postgis_sfcgal now can be installed as an extension using CREATE EXTENSION postgis_sfcgal;</para></note>
                                <note><para>PostGIS 2.2.0: Tiger Geocoder upgraded to work with TIGER 2014 data.</para></note>
-                                       
+                               <note><para>address_standardizer, address_standardizer_data_us extensions for standardizing address data refer to <xref linkend="Address_Standardizer" /> fpr details.</para></note>    
                                <para>Functions new in PostGIS 2.2</para>
                                <itemizedlist>
                                <!-- Pull out the purpose section for each ref entry and strip whitespace and put in a variable to be tagged unto each function comment  -->