--- a/ChangeLog	Fri Jun 24 09:34:21 2011 +0200
+++ b/ChangeLog	Fri Jun 24 10:29:44 2011 +0200
@@ -1,3 +1,12 @@
+2011-06-24  Stephan Holl  <stephan.holl@intevation.de>
+
+	* INSTALL.txt: added a hint how to install the converter and its
+	requirements.
+	* doku/source/conf.py, doku/source/INSTALL.txt,
+	doku/source/index.txt,doku/source/restrictions.txt,
+	doku/source/index.rst,doku/source/restrictions.rst: renamed .rst to
+	.txt, linked INSTALL.txt from root into the docs.
+
 2011-06-24  Stephan Holl  <stephan.holl@intevation.de>
 
 	* doku/Makefile, doku/source/conf.py, doku/source/index.rst,

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL.txt	Fri Jun 24 10:29:44 2011 +0200
@@ -0,0 +1,74 @@
+------------
+Requirements
+------------
+
+The current version of the converter only runs on Windows. This is because
+the ArcObjects JDK API is not running properly on Linux though.
+
+To run the converter you need at least the following componentes:
+
+ * Sun Java6 SDK to build, JRE to run
+ * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
+ * UMN MapServer with Java MapScript-bindings (recent development-version)
+ * Apache Webserver for displaying the resulting Mapfiles
+ * Optional: MapServer compiled with ArcSDE-plugin
+ * Optional: GDAL/OGR compiled with ArcSDE-support
+ * Optional: GDAL/OGR compiled with FileGeodatabase-support 
+
+
+
+------------
+Installation
+------------
+
+Compile the converter-sources
+-----------------------------
+
+To compile the sources you need to have a properly configured
+ant-environmet available. ArcGIS SDK provides an ant-installation which
+suffices::
+
+ ant jar
+
+Install Apache Webserver
+------------------------
+
+Install Apache webserver by exedcuting the .msi-file and follow the
+install-dialogs::
+
+ httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
+
+Make sure that you install apache as a service so it will be available
+directly after system bootup.
+
+
+Install UMN MapServer
+---------------------
+
+The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
+
+1. Unzip the ZIP-file at c:/ms_6.1-dev
+
+#. Configure Apache Webserver to find the cgi-bin-folder::
+
+    ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
+
+    <Location "/cgi-bin">
+        Options None
+        Order allow,deny
+        Allow from all
+    </Location>
+
+#. Copy mapserv.exe from c:/ms_6.1-dev/bin/apps/ms to c:/ms_6.1-dev/bin/
+
+Create run-environment
+----------------------
+
+writeme
+
+
+-----
+Usage
+-----
+
+writeme

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doku/source/INSTALL.txt	Fri Jun 24 10:29:44 2011 +0200
@@ -0,0 +1,1 @@
+../../INSTALL.txt
\ No newline at end of file

--- a/doku/source/conf.py	Fri Jun 24 09:34:21 2011 +0200
+++ b/doku/source/conf.py	Fri Jun 24 10:29:44 2011 +0200
@@ -31,7 +31,7 @@
 templates_path = ['_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = '.txt'
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'

--- a/doku/source/index.rst	Fri Jun 24 09:34:21 2011 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,22 +0,0 @@
-.. MXD2map documentation master file, created by
-   sphinx-quickstart on Mon Jun 20 09:48:05 2011.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to MXD2map's documentation!
-===================================
-
-Contents:
-
-.. toctree::
-   :maxdepth: 2
-
-   restrictions.rst
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doku/source/index.txt	Fri Jun 24 10:29:44 2011 +0200
@@ -0,0 +1,23 @@
+.. MXD2map documentation master file, created by
+   sphinx-quickstart on Mon Jun 20 09:48:05 2011.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to MXD2map's documentation!
+===================================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   INSTALL.txt
+   restrictions.txt
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+

--- a/doku/source/restrictions.rst	Fri Jun 24 09:34:21 2011 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,13 +0,0 @@
-------------
-Restrictions
-------------
-
-Currently there are some restrictions in the usage of the converter:
-
-Supported datasources:
-
- * ArcSDE-passwords cannot be read since they are encrypted. The converter
- exports the string "define me" which needs to be replaced later on in the
- resulting mapfile
-
- * 

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doku/source/restrictions.txt	Fri Jun 24 10:29:44 2011 +0200
@@ -0,0 +1,13 @@
+------------
+Restrictions
+------------
+
+Currently there are some restrictions in the usage of the converter:
+
+Supported datasources:
+
+ * ArcSDE-passwords cannot be read since they are encrypted. The converter
+ exports the string "define me" which needs to be replaced later on in the
+ resulting mapfile
+
+ *