--- /dev/null
+README.rpm
+-----------------------------------------------------------------------------
+Version 1.0.4, for PostGIS RPM Set
+Devrim Gunduz <devrim@gunduz.org>
+Sep 28, 2005
+-----------------------------------------------------------------------------
+
+INTRODUCTION
+-----------------------------------------------------------------------------
+This document exists to explain the layout of the RPM for PostGIS .
+
+This document is written to be applicable to version 1.0.X of PostGIS
+which is the current version of the RPM's as of this writing. More to the
+point, versions prior to 1.0.X are not documented here.
+
+It is preferable for the distribution-specific set to be the one used.
+If you want to stay up-to-date on the PostGIS core itself, use the community
+RPMS. These RPMs are kept up2date.
+
+PostGIS RPM is installed as every RPM, so it is not mentioned in here.
+
+RPM FILE LOCATIONS.
+-----------------------------------------------------------------------------
+To be in compliance with the Linux FHS, the PostGIS RPMs install files in
+a manner not consistent with most of the PostGIS documentation. According
+to the standard PostGIS documentation, PostGIS is installed under the
+directory /usr/local, with executables, source, and data existing in
+various subdirectories.
+
+Different distributions have different ideas of some of these file locations.
+In particular, the documentation directory can be /usr/doc, /usr/doc/packages,
+/usr/share/doc, /usr/share/doc/packages, or some other similar path. The current
+Red Hat / Fedora Core locations are listed below.
+
+However, the RPM's install the files like this:
+Executables: /usr/bin
+Libraries: /usr/lib
+Documentation: /usr/share/doc/postgis-x.y.z
+JDBC2 related: /usr/shara/java
+Perl utils: /usr/bin
+
+Use of 'rpm -ql' for each package is recommended as the 'Official' location source.
+
+While it may seem gratuitous to place these files in different locations, the
+FHS requires it -- distributions should not ever touch /usr/local. It may
+also seem like more work to keep track of where everything is -- but, that's
+the beauty of RPM -- you don't have to keep track of the files, RPM does it
+for you.
+
+These RPMs are designed to be LSB-compliant -- if you find this not to be the
+case, please let me know by way of the postgis-devel@PostGIS.org mailing
+list.
+
+REBUILDING FROM SOURCE RPM
+-------------------------------------------------------------------------------
+If your distribution is not supported by the binary RPM's from PostGIS.org,
+you will need to rebuild from the source RPM. Download the .src.rpm for this
+release. You will need to be root to rebuild, unless you have already set up
+a non-root build environment.
+
+Install the source RPM with rpm -i, then CD to the rpm building area (on RedHat
+or Fedora Core, this is /usr/src/redhat by default). You will have to have a full
+development environment to rebuild the RPM.
+
+This release of the RPM includes the ability to conditionally build
+sets of packages. The parameters, their defaults, and the meanings are:
+
+jdbc2: Build the RPM with jdbc2 support (default value is 1)
+utils: Build the RPM with perl utils (default value is 1)
+
+To use these defines, invoke a rebuild like this:
+rpm --rebuild --define 'jdbc2 0 ' --define 'utils' postgis-1.0.4-1.src.rpm
+
+This line would disable the jdbc2 and utils, if requested.
+
+Please note that the spec file needs some patches to PostGIS source tree to build, so you
+may need to download them via CVS before rebuilding the package.
+
+MORE INFORMATION
+-------------------------------------------------------------------------------
+You can get more information at http://www.PostGIS.org
+
+Please help make this packaging better -- let me know if you find problems, or
+better ways of doing things. You can reach us by e-mail at
+postgis-devel@PostGIS.org .
+
+-----------------------------------------------------------------------------
+