Updated the installations docs. I took some of Olivier Courtin instructions for insta...

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

diff --git a/doc/installation.xml b/doc/installation.xml
index 152b6750ce90c0dbcbdf28103e6cf3fad224b7e6..fe7a50269884e3ad9d0869d07794f9fb80878a3c 100644 (file)
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -84,50 +84,54 @@
           require recompiling your PostgreSQL from scratch, of course.</para>
         </note>
       </listitem>
-
-      <listitem>
+         
+         <para><note>The steps that follow are for Linux users.  They will not work on Windows without MingW and some other stuff</note></para>
+         <listitem>
+               <para>Check your settings to see which versions of things will be used</para>
+               <programlisting>
+               which gcc
+               which make &amp;&amp; which autoconf
+               which pg_config
+               sudo ldconfig -v | grep iconv
+               which flex &amp;&amp; which bison
+               sudo ldconfig -v | grep /usr/local/lib
+               which geos-config
+               sudo ldconfig -v | grep proj
+               </programlisting>
+         </listitem>
+         
+         <listitem>
+               <para>If you are missing proj based on above or running a version below 4.5, then install by following these steps.</para>
+               <programlisting>
+               wget http://download.osgeo.org/proj/proj-4.6.0.tar.gz
+               tar xvzf proj4-4.6.0.tar.gz
+               cd proj4-4.6.0
+               ./configure &amp;&amp; make clean &amp;&amp; make
+               sudo make install
+               sudo ldconfig
+               cd ..
+               </programlisting>
+         </listitem>
+
+         <listitem>
+               <para>If you are missing geos based on above or running a version below 3.0, then install by following these steps.</para>
+               <programlisting>
+               wget http://geos.refractions.net/downloads/geos-3.0.0.tar.bz2
+               tar xvjf geos-3.0.0.tar.bz2
+               cd geos-3.0.0
+               ./configure &amp;&amp; make clean &amp;&amp; make
+               sudo make install
+               sudo ldconfig
+               cd ..
+               </programlisting>
+         </listitem>
+         
+         <listitem>
         <para>Retrieve the PostGIS source archive from <ulink
-        url="http://postgis.refractions.net/postgis-&last_release_version;.tar.gz">http://postgis.refractions.net/postgis-&last_release_version;.tar.gz</ulink>.
-        Uncompress and untar the archive.</para>
-
-        <programlisting># gzip -d -c postgis-&last_release_version;.tar.gz | tar xvf -</programlisting>
-      </listitem>
-
-      <listitem>
-        <para>Enter the postgis-&last_release_version; directory, and run:
-        <programlisting># ./configure</programlisting></para>
-
-        <itemizedlist>
-          <listitem>
-            <para>PostgreSQL provides a utility called <filename>pg_config</filename> to enable
-            extensions like PostGIS to locate the PostgreSQL installation directory.
-            If ./configure didn't find <filename>pg_config</filename>,
-            try using the <code>--with-pgconfig=/path/to/pg_config</code> switch to specify a particular 
-            PostgreSQL installation.</para>
-          </listitem>
-
-          <listitem>
-            <para>Proj4 is now required in order to build and use PostGIS.
-            If ./configure didn't find the Proj4 library,
-            try using the <code>--with-projdir=/path/to/projdir</code> switch to specify an alternative
-            Proj4 installation directory.</para>
-          </listitem>
-
-          <listitem>
-            <para>GEOS is now required in order to build and use PostGIS.
-            If ./configure didn't find it, try using the 
-            <code>--with-geosconfig=/path/to/geos-config</code> switch to specify the full path 
-            to the <filename>geos-config</filename> program.</para>
-          </listitem>
-        </itemizedlist>
-      </listitem>
-
-      <listitem>
-        <para>Run the compile and install commands.</para>
-
-        <programlisting># make # make install</programlisting>
-
-        <para>All files are installed using information provided by
+        url="http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz">http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz</ulink>.
+        Uncompress and untar the archive. configure.</para>
+               
+               <para>All files are installed using information provided by
         <filename>pg_config</filename></para>
 
         <itemizedlist>
@@ -147,39 +151,80 @@
             <filename>[bindir]/</filename>.</para>
           </listitem>
         </itemizedlist>
-      </listitem>
 
-      <listitem>
-        <para>PostGIS requires the PL/pgSQL procedural language extension.
-        Before loading the <filename>lwpostgis.sql</filename> file, you must
-        first enable PL/pgSQL. You should use the
-        <filename>createlang</filename> command. The PostgreSQL Programmer's
-        Guide has the details if you want to this manually for some
-        reason.</para>
-
-        <programlisting># createlang plpgsql [yourdatabase]</programlisting>
-      </listitem>
-
-      <listitem>
-        <para>Now load the PostGIS object and function definitions into your
-        database by loading the <filename>lwpostgis.sql</filename> definitions
-        file.</para>
-
-        <programlisting># psql -d [yourdatabase] -f lwpostgis.sql</programlisting>
-
-        <para>The PostGIS server extensions are now loaded and ready to
-        use.</para>
-      </listitem>
-
-      <listitem>
-        <para>For a complete set of EPSG coordinate system definition
-        identifiers, you can also load the
-        <filename>spatial_ref_sys.sql</filename> definitions file and populate
-        the <varname>SPATIAL_REF_SYS</varname> table.</para>
-
-        <programlisting># psql -d [yourdatabase] -f spatial_ref_sys.sql</programlisting>
-      </listitem>
-    </orderedlist>
+        <programlisting>
+                       wget http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz
+                       gzip -d -c postgis-&last_release_version;.tar.gz | tar xvf -
+                       cd postgis-&amp;last_release_version;/
+                       sh autogen.sh
+                       ./configure
+               </programlisting>
+       </listitem>
+               
+               
+       <listitem>
+                <para>Make and Install</para>
+               <itemizedlist>
+                 <listitem>
+                       <para>PostgreSQL provides a utility called <filename>pg_config</filename> to enable
+                       extensions like PostGIS to locate the PostgreSQL installation directory.
+                       If ./configure didn't find <filename>pg_config</filename>,
+                       try using the <code>--with-pgconfig=/path/to/pg_config</code> switch to specify a particular 
+                       PostgreSQL installation.</para>
+                 </listitem>
+
+                 <listitem>
+                       <para>Proj4 is now required in order to build and use PostGIS.
+                       If ./configure didn't find the Proj4 library,
+                       try using the <code>--with-projdir=/path/to/projdir</code> switch to specify an alternative
+                       Proj4 installation directory.</para>
+                 </listitem>
+
+                 <listitem>
+                       <para>GEOS is now required in order to build and use PostGIS.
+                       If ./configure didn't find it, try using the 
+                       <code>--with-geosconfig=/path/to/geos-config</code> switch to specify the full path 
+                       to the <filename>geos-config</filename> program.</para>
+                 </listitem>
+               </itemizedlist>
+               <programlisting>
+                       make clean &amp;&amp; make
+                       sudo make install
+                       sudo ldconfig
+               </programlisting>
+       </listitem>
+     
+
+       <listitem>
+               <para>PostGIS requires the PL/pgSQL procedural language extension.
+               Before loading the <filename>lwpostgis.sql</filename> file, you must
+               first enable PL/pgSQL. You should use the
+               <filename>createlang</filename> command. The PostgreSQL Programmer's
+               Guide has the details if you want to this manually for some
+               reason.</para>
+               
+               <programlisting># createlang plpgsql [yourdatabase]</programlisting>
+       </listitem>
+       
+       <listitem>
+               <para>Now load the PostGIS object and function definitions into your
+               database by loading the <filename>lwpostgis.sql</filename> definitions
+               file.</para>
+               
+               <programlisting># psql -d [yourdatabase] -f lwpostgis.sql</programlisting>
+               
+               <para>The PostGIS server extensions are now loaded and ready to
+               use.</para>
+       </listitem>
+       
+       <listitem>
+               <para>For a complete set of EPSG coordinate system definition
+               identifiers, you can also load the
+               <filename>spatial_ref_sys.sql</filename> definitions file and populate
+               the <varname>SPATIAL_REF_SYS</varname> table.</para>
+               
+               <programlisting># psql -d [yourdatabase] -f spatial_ref_sys.sql</programlisting>
+       </listitem>
 
     <sect2 id="templatepostgis">
       <title>Creating PostGIS spatially-enabled databases from an in-built
@@ -339,6 +384,7 @@ newdb=&gt; \i spatial_ref_sys.sql</programlisting>
         </listitem>
       </orderedlist>
     </sect2>
+       </orderedlist>
   </sect1>
 
   <sect1>