fix off-by-one after switching on the brain again

[deb/packages.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 641cee2d1280d3d008167bb0aca353de15a4cd6e..b72a708834864217c86e97dd7012d03f722e4361 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,34 +4,43 @@ INSTALL
 This should give you an idea about the basic steps. It is probably very rough
 around the edges, feel free to ask for clarifications so we can improve it.
 
 This should give you an idea about the basic steps. It is probably very rough
 around the edges, feel free to ask for clarifications so we can improve it.
 

-This guide assumes you are working on a Debian etch system. If that is not the
+This guide assumes you are working on a Debian lenny system. If that is not the

 case, you might have to adjust some of the steps.
 
 1) Install git (package git-core). You will get a much more pleasant user
 case, you might have to adjust some of the steps.
 
 1) Install git (package git-core). You will get a much more pleasant user

-   experience if you use a version from backports.org or a self-compiled one
-   instead of etch's version.
-2) Download the code from git://source.djpig.de/git/packages.git
-   (Something like `git clone git://source.djpig.de/git/packages.git')
-3) Install the needed dependencies. A list can be found in cron.d/050checkinst.
-   One dependency can't be fulfilled directly from etch and is therefor not listed
-   there: the Search::Xapian perl module. You can either compile that yourself against
-   libxapian from etch, backport all of xapian and libsearch-xapian-perl from
-   lenny, or install the 0.9.9-1 deb from snapshots.debian.net.
-4) Install apache2 (apache2-mpm-worker) and mod_perl (libapache2-mod-perl2)
-5) Adjust the configuration to your needs. You should at least edit the following
-   files before starting to test:
+   experience if you use a version from backports.debian.org or a self-compiled
+   one instead of lenny's version.
+2) Download the code from git://git.debian.org/git/webwml/packages.git
+   (Something like `git clone git://git.debian.org/git/webwml/packages.git')
+3) Install the needed dependencies. A list can be found in debian/control.
+4) Install apache2 (apache2-mpm-worker), mod_perl (libapache2-mod-perl2) and
+   Apache2::Reload (libapache2-reload-perl)
+5) Adjust the configuration to your needs. You should at least edit the
+   following files before starting to test (don't touch %TOPDIR% and %SITE%, as
+   you will specify it later):

    - ./config.sh.sed.in
    - ./config.sh.sed.in

+     (especially : admin_email, and localdir and/or ftproot if you have local
+     caches)

    - ./templates/config.tmpl
    - ./templates/config.tmpl

+     (especially : packages_homepage)

    - ./templates/config/*
    - ./templates/config/*

+     (especially if you have your own repositories)

    - ./conf/apache.conf.sed.in
 6) run `./bin/setup-site <topdir> <site>'
    - ./conf/apache.conf.sed.in
 6) run `./bin/setup-site <topdir> <site>'

-   (e.g. `./bin/setup-site /org/packages.debian.org packages.debian.org')
-7) create a cache directory for the compiled templates, it needs to be writable by
-   apache (i.e. on default etch by www-data). Default location is
-   <topdir>/cache
-7) Include ./conf/apache.conf in apache's configuration, e.g. by symlinking it from
-   /etc/apache2/sites-available/ and then using a2ensite
-8) Run ./bin/daily
-9) Setup ./bin/daily to be run regulary. In ./conf/crontab you can find an example crontab
-   to do this. Actually preferable is to trigger the script by archive updates, but you
-   will know best if and how to implement that in your setup.
+   (e.g. `./bin/setup-site /srv/packages.debian.org packages.debian.org')
+7) create a cache directory for the compiled templates, it needs to be writable
+   by apache (i.e. on default lenny by www-data). Default location is
+   <topdir>/cache. So
+   chown www-data <topdir>/cache
+   chmod 2770 <topdir>/cache
+8) Include ./conf/apache.conf in apache's configuration, e.g. by symlinking it
+   from /etc/apache2/sites-available/ and then using a2ensite
+9) Enable at least the following apache modules: `a2enmod expires rewrite'
+10) Run ./bin/daily
+   (this takes a while, especially the first time, as it downloads a lot of
+   data, [at the time of this writing approx. 900 MB], creates databases,
+   pre-builds heavy pages, etc.)
+11) Set up ./bin/daily to be run regulary. In ./conf/crontab you can find an
+   example crontab to do this. Actually preferable is to trigger the script by
+   archive updates, but you will know best if and how to implement that in your
+   setup.