[Thuban-commits] r2727 - in trunk/thuban: . Doc/manual
scm-commit@wald.intevation.org
scm-commit at wald.intevation.org
Tue Feb 20 11:44:52 CET 2007
Author: bernhard
Date: 2007-02-20 11:44:51 +0100 (Tue, 20 Feb 2007)
New Revision: 2727
Modified:
trunk/thuban/ChangeLog
trunk/thuban/Doc/manual/thuban-manual.xml
Log:
Doc/manual/thuban-manual.xml: Removed the installation instructions
as they are outdated and they should be only in one place.
Bumped version number of the document to 1.2.0. Marked it as Draft
in the title.
Modified: trunk/thuban/ChangeLog
===================================================================
--- trunk/thuban/ChangeLog 2007-02-20 10:37:57 UTC (rev 2726)
+++ trunk/thuban/ChangeLog 2007-02-20 10:44:51 UTC (rev 2727)
@@ -1,5 +1,10 @@
2007-02-20 Bernhard Reiter <bernhard at intevation.de>
+ * Doc/manual/thuban-manual.xml: Removed the installation instructions
+ as they are outdated and they should be only in one place.
+ Bumped version number of the document to 1.2.0. Marked it as Draft
+ in the title.
+
* Extensions/svgexport/: Get ready for release. Bump version
number to 1.0.1. Adjusted numbers in TODO.
Modified: trunk/thuban/Doc/manual/thuban-manual.xml
===================================================================
--- trunk/thuban/Doc/manual/thuban-manual.xml 2007-02-20 10:37:57 UTC (rev 2726)
+++ trunk/thuban/Doc/manual/thuban-manual.xml 2007-02-20 10:44:51 UTC (rev 2727)
@@ -6,7 +6,7 @@
<!-- $Revision$ -->
<book>
<bookinfo>
- <title>User's Manual for Thuban 1.0</title>
+ <title>User's Manual for Thuban 1.2 (Draft)</title>
<authorgroup>
<author>
<firstname>Jonathan</firstname><surname>Coles</surname>
@@ -19,17 +19,28 @@
</author>
</authorgroup>
<copyright>
- <year>2003, 2004, 2005, 2006</year>
+ <year>2003, 2004, 2005, 2006, 2007</year>
<holder>Intevation GmbH</holder>
</copyright>
<revhistory>
<!-- comment this first revision out when releasing a real version -->
+<!--
<revision>
<revnumber>SVN version $Id$</revnumber>
<date></date>
<revremark>Under development.</revremark>
</revision>
+-->
<revision>
+ <revnumber>1.2.0</revnumber>
+ <date>20-Feb-2007</date>
+ <revremark>
+ Removed all installation instructions in favor
+ of a link to the website. It is not wise to
+ double the README contents here.
+ </revremark>
+ </revision>
+ <revision>
<revnumber>1.0.0</revnumber>
<date>22-Jan-2004</date>
<revremark>
@@ -90,301 +101,15 @@
<section><title>Installation</title>
<para>
- Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
- and Windows 2000. Thuban depends on the following packages. These
- packages can also be found on the
- <ulink url="http://thuban.intevation.org/download.html">
- Thuban Download site
- </ulink>.
- </para>
- <para>
- Required:
- <itemizedlist>
- <listitem><para>Python 2.2.1
- (<literal>http://www.python.org</literal>)
- </para></listitem>
- <listitem><para>wxWindows 2.4
- (<literal>http://www.wxwindows.org</literal>)
- </para></listitem>
- <listitem><para>wxPython 2.4
- (<literal>http://www.wxpython.org</literal>)
- </para></listitem>
- <listitem><para>proj 4.4.5 Projection Library
- (<literal>http://www.remotesensing.org/proj/</literal>)
- </para></listitem>
- <listitem><para>SQLite 2.8.3
- <literal>http://www.hwaci.com/sw/sqlite/</literal>)
- </para></listitem>
- <listitem><para>PySQLite 0.4.3
- (<literal>http://pysqlite.sourceforge.net</literal>)
- </para></listitem>
- </itemizedlist>
- </para>
- <para>
- Optional:
- <itemizedlist>
- <listitem><para>GDAL 1.1.8
- (<literal>http://www.remotesensing.org/gdal/</literal>)
- </para></listitem>
- <listitem><para>psycopg 1.0.8
- (<literal>http://initd.org/software/psycopg</literal>)
- </para></listitem>
- </itemizedlist>
- </para>
- <para>
- Along with the source codes, the download page also offers full
- installation packages for Debian, Windows and RPM-based systems
- (Mandrake, RedHat, SuSE, etc).
- </para>
- <section><title>RPM-based GNU/Linux Systems</title>
- <section><title>Installing Binary Packages</title>
- <para>
- The most wide-spread RPM-based GNU/Linux
- Systems are RedHat, Mandrake and SuSE.
- The documentation of these distributions
- should contain information about how to
- install third-party RPM packages.
- Nonetheless, a short summary is provided here.
- </para>
- <para>
- RPM packages can be installed applying several
- tools. The most basic one is the command line
- program "rpm". The hardware architecture is
- identified in the name of RPM packages, eg.
- 'i386' for most Intel/AMD architectures.
- If you have a different hardware architecture,
- where no binary RPM packages are provided,
- you must rebuild binary packages from the
- RPM source packages first (see below).
- Typical rpm commands look like:
+ Thuban is actively supported under Debian 4.0 (Etch)
+ and Windows (XP). Of course it is possible to run Thuban
+ on a variety of other platforms.
- <programlisting>
- rpm --install Thuban-0.9.0-1.i386.rpm
- </programlisting>
-
- Depending on what you already have installed
- on your system, you are informed that some
- packages are required, but not installed.
- You need to install them first. Either they
- are provided by your GNU/Linux distributor
- or available somewhere on the Internet.
- The more essential and special ones are
- provided together with the Thuban package.
- </para>
-
- <para>
- For rpm exist some graphical user interfaces, notably
- kpackage, GnoRPM and xrpm.
- </para>
-
- <para>
- Make yourself familiar with one of the tools and apply it
- to install the packages.
- Note, that you need to be administrator (root) for the system
- to do that.
- </para>
- </section>
- <section><title>Build Binaries from Source Packages</title>
- <para>
- This section describes howto build RPM install-packages
- from RPM source-packages.
- This adapts and optimizes an install-package specifically
- to your system.
- This is especially helpful to resolve version conflicts of
- dependent packages. Furthermore, install-packages for other
- platforms (e.g. PowerPC) can be created.
- </para>
-
- <para>
- Note: rpm must be at least version 4. Execute
- <literal>rpm --version</literal> to find out about the version.
- </para>
-
- <para>
- You need to do the following preparations to be able to
- build the packages as a regular user. You should now
- perform the package buling as root since this
- might cause damage to your system.
- <itemizedlist>
- <listitem>
- <para>
- Create RPM directory structure:
- Choose a directory (e.g. $HOME/myrpm) and create the
- subdirectories BUILD, RPM, SOURCES, SPECS and SRPMS.
- A possible command sequence for this is:
- <programlisting>
- mkdir $HOME/freegisrpm
- cd $HOME/freegisrpm
- mkdir BUILD RPMS SOURCES SPECS SRPMS
- </programlisting>
- </para>
- </listitem>
- <listitem>
- <para>
- Set environment variable RPM_DIR:
- <programlisting>
- export RPM_DIR=$HOME/freegisrpm
- </programlisting>
- </para>
- </listitem>
- <listitem>
- <para>
- Create $HOME/.rpmmacros:
- This file sets general preferences and some
- specific settings for signing packages.
- If you don't have a GnuPG-key, you can skip
- the signature settings i.e. drop the last 4 lines.
- A signature becomes important when you want to
- give away packages to third parties.
- <programlisting>
-<![CDATA[
-%packager Name Lastname <Name.Lastname at mydomain.example>
-
-%_topdir /home/mylogin/myrpm
-
-%_signature gpg
-%_gpg_name Name Lastname
-%_pgp_path ~/.gnupg
-%_pgpbin /usr/bin/gpg
-]]>
- </programlisting>
- </para>
- </listitem>
- </itemizedlist>
-
- Now you can install any RPM source-package.
- It's components are installed into the corresponding
- subdirectories of your rpm-directory.
- Essentially these are the sources (into directory SOURCES)
- and the so-called spec-file which contains all build
- instructions. The spec-file will go into the SPEC directory.
- Example:
- <literal>rpm --install Thuban-0.9.0-1.src.rpm</literal>
- </para>
-
- <para>
- Create install-package:
- Go to the directory with the spec-files and rebuild the
- package:
- <programlisting>
-cd $HOME/mypm/SPECS
-rpm -bb thuban.spec
- </programlisting>
- Next, you will find the newly created package in
- $HOME/myrpm/RPMS/i386.
- If you build the package for another architecture than
- i386, then the name of the directory has a corresponding name.
- </para>
- <para>
- For documentation of RPM, either type
- <literal>man rpm</literal> or <literal>rpm --help</literal>.
- This will provide you with information on the various command
- line options of RPM.
- For more information see the
- <ulink url="http://www.rpm.org/">homepage of RPM</ulink>.
- </para>
- </section>
- </section> <!-- Intro - Installation - RPM-->
-
- <section><title>Win32 Systems</title>
- <para>
- A common installation package of Thuban for Win32
- systems is available from the Thuban website download
- section. This installation package is configured for
- displaying file based vector data (Shapefiles). For the
- display of raster data or the connection to spatial
- databases additional steps are needed.
- </para>
- <para>
- The required Python packages are listed and linked on
- the download page as well. If you don't have Python
- installed already, download the packages for Python,
- wxPython for Python and the SQLite Python Libraries as
- well as the Thuban package. Install all four packages
- in the order: Python, wxPython, SQLite, Thuban. Follow
- the installation instructions provided by the seperate
- setups. The Thuban installation package will add an
- entry in the menu folder you configured.
- </para>
- <section><title>Raster Data: Installation of GDAL</title>
- <para>
- Enabling the raster data features of Thuban is
- straight forward. For the examples we assume that
- Thuban has been installed under
- <literal>C:\Thuban</literal>:
- <itemizedlist>
- <listitem>
- <para>
- Download the zip-archive <ulink
- url="ftp://intevation.de/thuban/win2k/gdal-win2k.zip"
- >gdal-win2k</ulink>.
- </para></listitem>
- <listitem><para>Extract the archive (e.g. with
- <ulink
- url="http://www.info-zip.org/pub/infozip/WiZ.html"
- >WiZ (InfoZip)</ulink>) into the
- <literal>C:\Thuban\Lib</literal>
- directory of your Thuban installation.
- </para>
- </listitem>
- <listitem>
- <para>
- Extent the <varname>PYTHONPATH</varname>
- environment variable (in your Windows Control Panel)
- to make the new libraries available for Thuban.
- <programlisting>
-%PYTHONPATH%;C:\Thuban\Lib\gdal;C:\Thuban\Lib\gdal\pymod
- </programlisting>
- </para>
- </listitem>
- <listitem>
- <para>
- Extent also the <varname>PATH</varname>
- environment variable accordingly:
- <programlisting>
-%PATH%;C:\Thuban\Lib\gdal
- </programlisting>
- </para>
- </listitem>
- </itemizedlist>
- After this installation steps Thuban is ready to
- display raster data (e.g. the
- <literal>island.tif</literal> from the Iceland Demo
- data set.
- </para>
- </section> <!-- Win32: GDAL-->
-
- <section><title>Working with PostGIS: Installation of PsycoPG</title>
- <para>
- To access PostgreSQL/PostGIS spatial databases with
- Thuban you have to install the PsycoPG package for
- Windows:
- <itemizedlist>
- <listitem>
- <para>
- Download the zip-archive
- <ulink
- url="http://stickpeople.com/projects/python/win-psycopg/win-psycopg22.zip"
- >win-psycopg22.zip</ulink>.
- </para>
- </listitem>
- <listitem>
- <para>
- Extract the zip-archive into a directory either already
- in your <varname>PYTHONPATH</varname> or extent your
- <varname>PYTHONPATH</varname> variable to the directory
- you have extracted the archive to.
- </para>
- </listitem>
- </itemizedlist>
- For installation and maintenance of spatial databases
- we refer to the <ulink
- url="http://postgis.refractions.net"
- >PostGIS Homepage</ulink>.
- </para>
- </section> <!-- Win32: PsycoPG-->
-
- </section> <!-- Intro - Installation - Win32 -->
+ Please check <ulink url="http://thuban.intevation.org/">
+ Thuban's Website
+ </ulink> about how to install Thuban and the lastest information
+ about the supported platforms.
+ </para>
</section>
<section><title>Internationalization</title>
More information about the Thuban-commits
mailing list