Update for new upstream snapshot

[memories.git] / debian / README.Debian

diff --git a/debian/README.Debian b/debian/README.Debian
index f2429770949671d05f137662cb363fe9f37e267f..6ca9bfca74a41a124eb2b4df49f79bacb30b765d 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,12 +1,21 @@
-This Debian package of Memories configures any installed version of
-Apache with mod_perl so that Memories is available through the path
-/memories/.  This is controlled by /etc/memories/apache.conf.
+You can run Memories through CGI or Apache's mod_perl:
 
-In order to run Memories you will need to set up a MySQL database
-using the schema given in /usr/share/memories/memories.sql and allow
-the www-data user permission to delete, insert, select and update in
-all the given tables.  The following commands should work, if the
-database server is on the same computer:
+- The CGI script is /usr/lib/cgi-bin/memories.cgi.
+
+- Use of mod_perl is configured in /etc/memories/apache.conf,
+  which by default uses the path /memories/.  If you use mod_perl
+  you must also enable mod_apreq.  If both these modules are
+  enabled for Apache 2 when Memories is installed or upgraded,
+  Memories is added to the Apache configuration automatically.
+  To do this later, run:
+      ln -s ../../memories/apache.conf /etc/apache2/conf.d/memories
+
+In order to run Memories you will need to set up a database with the
+schema given in /usr/share/memories/memories.sql and grant the
+www-data user permission to delete, insert, select and update in all
+the tables in that schema.  Currently only MySQL databases are
+supported.  You can set up a suitable database with the following
+commands in the mysql client:
 
     mysql> create database memories;
     mysql> use memories
@@ -15,8 +24,9 @@ database server is on the same computer:
     mysql> quit
 
 The configuration file for Memories itself is /etc/memories/Config.pm.
-You will almost certainly need to change the 'uri_base' parameter in
-this to match your web site configuration.  You will also need to
-change the 'dsn' parameter if the database name is not 'memories'.
+You will almost certainly need to change the 'uri_base' and
+'data_store_external' parameters in this to match your web site
+configuration.  You will also need to change the 'dsn' parameter if
+the database name is not 'memories'.
 
- -- Ben Hutchings <ben@decadentplace.org.uk>  Fri, 17 Feb 2006 01:34:47 +0000
+ -- Ben Hutchings <ben@decadent.org.uk>  Tue, 21 Aug 2007 00:37:26 +0100