20070509-1: README.Debian + apache.conf.gz patches

[boud]

hi samizdat-devel,

The README.Debian file is quite nice. i installed 20070509-1 from scratch
in a debian-etch distribution following the exact instructions in 
README.Debian.

There *were* a few minor changes necessary.

There are also a few ambiguous comments in the examples/apache.conf.gz file.

And i think it would be useful to warn the sysadmin that there are also
config files in /etc/samizdat/ - e.g. /etc/samizdat/sites   needs to
be changed if someone is setting up a remote site. (i spent a couple of
hours tracing this "RTFM-pseudo-bug".)  Of course, s/he should in principle
also read "install.txt", but since README.Debian seems to be a potential
basis from which to develop a completely one-line

 aptitude install samizdat

package at some time in the future for getting into stable (with lots
of checks and failsafes added on), i think this it's important to 
keep correcting these "little" bugs.

Anyway, these are my recommended changes.

Any objections?

cheers
boud





--- /20070509-1/usr/share/doc/samizdat/README.Debian    2007-05-09 
22:46:40.000000000 +0200
+++ /usr/share/doc/samizdat/README.Debian       2007-05-12 04:03:09.832574912 
+0200
@@ -42,8 +42,18 @@

 2) Configure Apache:

-cp /usr/share/samizdat/doc/examples/apache.conf \
-  /etc/apache2/sites-available/samizdat
+# install configuration file:
+cp /usr/share/doc/samizdat/examples/apache.conf.gz \
+  /etc/apache2/sites-available/samizdat.gz
+gunzip /etc/apache2/sites-available/samizdat.gz
+
+# enable it
+ln -s /etc/apache2/sites-available/samizdat \
+  /etc/apache2/sites-enabled/samizdat
+
+# create relevant directories
+mkdir -p /var/www/samizdat/ /var/www/samizdat/content/
+chown www-data:www-data /var/www/samizdat/content/
 mkdir -p /var/log/apache2/samizdat

 3) Create PostgreSQL database and configure IDENT access for CGI
@@ -68,7 +78,9 @@
   # IPv6 local connections:
   host    all         all         ::1/128               md5

-4) http://localhost/samizdat/
+4) Restart apache and samizdat and look at http://localhost/samizdat/
+with a web browser. To test a remote server, first edit apache and
+/etc/samizdat/ configuration files.


 Explanations


--- /20070509-1/usr/share/doc/samizdat/apache.conf      2007-04-22 
15:51:48.000000000 +0200
+++ /usr/share/doc/samizdat/apache.conf         2007-05-11 22:26:29.069557680 
+0200
@@ -84,9 +84,11 @@
 # Apache configuration for Samizdat engine - Directory-based site
 #

-# Change "/var/www/samizdat/content/" to wherever you want your
-# uploaded files to be stored. Make sure the directory is writable
-# by web server user (www-data)
+# Replace the first "/samizdat" here with your site location for all
+# aliases.
+# Also, change "/var/www/samizdat/content/" to wherever you want your
+# uploaded files to be stored. Make sure the directory is writable by
+# web server user (www-data).
 Alias /samizdat/content/ /var/www/samizdat/content/
 <Directory /var/www/samizdat/content>
     Options Indexes
@@ -102,7 +104,7 @@
     </LimitExcept>
 </Directory>

-# Replace "/samizdat" with your site location for all aliases
+# Replace the first "/samizdat" here with your site location for all aliases
 Alias /samizdat/css/ /usr/share/samizdat/css/

 AliasMatch ^/samizdat/(dispatch)\.rb /usr/share/samizdat/cgi-bin/$1.rb



#----------------------------------------------------------------------