From baaec0c9704e1e8aa7426094ab5d25c49b3e3ee1 Mon Sep 17 00:00:00 2001
From: richard <richard@57a73879-2fb5-44c3-a270-3262357dd7e2>
Date: Mon, 23 Jul 2001 08:55:04 +0000
Subject: [PATCH] renamed the text files so that they're recognised as text
 files on windows added INSTALL.TXT

git-svn-id: http://svn.roundup-tracker.org/svnroot/roundup/trunk@57 57a73879-2fb5-44c3-a270-3262357dd7e2
---
 CHANGES => CHANGES.TXT |  0
 INSTALL.TXT            | 82 ++++++++++++++++++++++++++++++++++++++++++
 README => README.TXT   |  0
 3 files changed, 82 insertions(+)
 rename CHANGES => CHANGES.TXT (100%)
 create mode 100644 INSTALL.TXT
 rename README => README.TXT (100%)

diff --git a/CHANGES b/CHANGES.TXT
similarity index 100%
rename from CHANGES
rename to CHANGES.TXT
diff --git a/INSTALL.TXT b/INSTALL.TXT
new file mode 100644
index 0000000..4d236f4
--- /dev/null
+++ b/INSTALL.TXT
@@ -0,0 +1,82 @@
+                                    Roundup
+                                    =======
+
+
+Installation
+===============
+These instructions work on redhat 6.2 and mandrake 8.0 - with the caveat
+that these systems don't come with python 2.0 or newer installed, so you'll
+have to upgrade python before this stuff will work.
+
+Roundup is configurable using a localconfig.py file in the instance home.
+It may have the following variable declarations:
+  
+  MAILHOST - The SMTP mail host that roundup will use to send mail
+  MAIL_DOMAIN - The domain name used for email addresses
+
+Any further configuration should be possible by editing the instance home's
+__init__.py directly.
+
+The email addresses used by the system by default are:
+
+  issue_tracker@MAIL_DOMAIN  - submissions of issues
+  roundup-admin@MAIL_DOMAIN  - roundup's internal use (problems, etc)
+
+
+Prerequisites
+-----------------
+Either:
+ . Python 2.0 with pydoc installed. See http://www.lfw.org/ for pydoc.
+or
+ . Python 2.1
+
+Both need the anydbm or bsddb module.
+
+
+
+Initial Setup
+=============
+
+Instance
+--------
+Try "./roundup-admin init" :)
+
+
+Mail
+----
+Set up a mail alias called "issue_tracker" as:
+  "|/usr/bin/python /home/httpd/html/roundup/roundup-mailgw <instance_home>"
+
+In some installations (e.g. RedHat 6.2 I think) you'll need to set up smrsh
+so sendmail will accept the pipe command. In that case, symlink
+/etc/smrsh/python to /usr/bin/python and change the command to:
+  "|python /home/httpd/html/roundup/roundup-mailgw <instance_home>"
+
+
+Web Interface
+-------------
+This software will work through apache or stand-alone.
+
+Stand-alone:
+ 1. Edit roundup-server at the top - ROUNDUP_INSTANCE_HOMES needs to know
+    about your instance.
+ 2. "./roundup-server [hostname port]"   (hostname may be "")
+ 3. Load up the page "/" using the port number you set.
+
+Apache:
+ 1. Make sure roundup.cgi is executable. Edit it at the top -
+    ROUNDUP_INSTANCE_HOMES needs to know about your instance.
+ 2. Edit your /etc/httpd/conf/httpd.conf and make sure that the
+    /home/httpd/html/roundup/roundup.cgi script will be treated as a CGI
+    script.
+ 3. Add the following to your /etc/httpd/conf/httpd.conf:
+------8<------- snip here ------8<-------
+RewriteEngine on
+RewriteCond %{HTTP:Authorization} ^(.*)
+RewriteRule ^/roundup/roundup.cgi(.*) /home/httpd/html/roundup/roundup.cgi$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]
+------8<------- snip here ------8<-------
+   note: the RewriteRule must be on one line - no breaks
+ 4. Re-start your apache to re-load the config
+ 5. Load up the page "/roundup/roundup.cgi/"
+
+
diff --git a/README b/README.TXT
similarity index 100%
rename from README
rename to README.TXT
-- 
2.30.2