[postgis-devel] @@LAST_RELEASE_VERSION@@ substitution fails in SVN trunk

[Kevin Neufeld]

Sorry I've been out of touch as of late ... been away on vacation for 
the last week.  fun fun!

Mark, yes there is.
Put a
<!ENTITY last_release_version "@@LAST_RELEASE_VERSION@@">
with the other system references in postgis.xml.  Then reference your 
variable using &last_release_version;

Try the attached patch.
Cheers,
Kevin


Mark Cave-Ayland wrote:
> Hi everyone,
> 
> I've been looking at the new documentation in SVN trunk with regard to
> submitting patches, and I've noticed that according to the Makefile, the
> @@LAST_RELEASE_VERSION@@ substitution is only being performed on the
> postgis.xml file. Since the documentation has now been split into multiple
> parts, it means the substitution is missing from several places; for
> example look at this page here:
> http://postgis.refractions.net/documentation/manual-svn/ch02.html.
> 
> I'm wondering if there is a way of definining the version number as an
> entity at the top of postgis.xml (similar to the external references) so
> that it automatically gets substituted throughout the rest of the
> documentation. Anyone know if this is possible?
> 
> 
> ATB,
> 
> Mark.
> 
-------------- next part --------------
Index: installation.xml
===================================================================
--- installation.xml	(revision 2876)
+++ installation.xml	(working copy)
@@ -52,12 +52,12 @@
     <title>PostGIS</title>
 
     <para>The PostGIS module is a extension to the PostgreSQL backend server.
-    As such, PostGIS @@LAST_RELEASE_VERSION@@ <emphasis>requires</emphasis>
+    As such, PostGIS &last_release_version; <emphasis>requires</emphasis>
     full PostgreSQL server headers access in order to compile. The PostgreSQL
     source code is available at <ulink
     url="http://www.postgresql.org">http://www.postgresql.org</ulink>.</para>
 
-    <para>PostGIS @@LAST_RELEASE_VERSION@@ can be built against PostgreSQL
+    <para>PostGIS &last_release_version; can be built against PostgreSQL
     versions 7.2.0 or higher. Earlier versions of PostgreSQL are
     <emphasis>not</emphasis> supported.</para>
 
@@ -81,14 +81,14 @@
 
       <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>.
+        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>
+        <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:
+        <para>Enter the postgis-&last_release_version; directory, and run:
         <programlisting># ./configure</programlisting></para>
 
         <itemizedlist>
@@ -380,7 +380,7 @@
     <para>The data loader and dumper are built and installed automatically as
     part of the PostGIS build. To build and install them manually:</para>
 
-    <programlisting># cd postgis-@@LAST_RELEASE_VERSION@@/loader 
+    <programlisting># cd postgis-&last_release_version;/loader 
 # make 
 # make install</programlisting>
 
Index: postgis.xml
===================================================================
--- postgis.xml	(revision 2876)
+++ postgis.xml	(working copy)
@@ -2,6 +2,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 
+<!ENTITY last_release_version "@@LAST_RELEASE_VERSION@@">
 <!ENTITY introduction SYSTEM "introduction.xml">
 <!ENTITY installation SYSTEM "installation.xml">
 <!ENTITY faq SYSTEM "faq.xml">
@@ -14,7 +15,7 @@
 
 ]>
 <book>
-  <title>PostGIS @@LAST_RELEASE_VERSION@@ Manual</title>
+  <title>PostGIS &last_release_version; Manual</title>
 
   <bookinfo>
     <editor>
@@ -39,7 +40,7 @@
       GiST-based R-Tree spatial indexes, and functions for analysis and
       processing of GIS objects.</para>
 
-      <para>This is the manual for version @@LAST_RELEASE_VERSION@@</para>
+      <para>This is the manual for version &last_release_version;</para>
     </abstract>
   </bookinfo>