X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=docs%2FREADME.first;h=1f5d23a4d6ae97d71917aa1f21c2ba71eb6bd56d;hb=f1c6b12f17fd63c6b6e644deff776dc378fdadad;hp=5a526ac8a81f207916492cbe6d4f5adc31968620;hpb=86b1104fb607ba8527969f9b1ee349532ae6fe58;p=dak.git

diff --git a/docs/README.first b/docs/README.first
index 5a526ac8..1f5d23a4 100644
--- a/docs/README.first
+++ b/docs/README.first
@@ -101,10 +101,24 @@ o katie - common code used by lisa, jennifer, kelly and others
 
 [Very incomplete - FIXME]
 
-o Write your own katie.conf and apt.conf files
-o Run rose
+o Write your own katie.conf and apt.conf files.  katie looks for those
+  config files in /etc/katie/.  /etc/katie/katie.conf can define
+  alternative configuration files with Config::host::KatieConfig and
+  Config::host::AptConfig (where "host" is the fully qualified domain
+  name of your machine).
+o Create a PostgreSQL database on the host given in katie.conf's DB::Host
+  with the name specified in DB::Name.
+o Run rose: this will create all directories which are specified in
+  katie.conf and apt.conf.
 o If you have an existing archive:
    * Run neve
   otherwise:
-   * Run alyson
+   * Create the table structure.  init_pool.sql contains all SQL statements
+     which are needed for this.  After changing all occurences of "projectb"
+     to the name of your database (as defined in DB::Name) you can run:
+         psql DB::Name < init_pool.sql
+   * Run alyson: it will populate your database with the values from
+     katie.conf and apt.conf.
+   * Copy all templates from the "templates" directory to to the directory
+     specified in Dir::Templates, and adapt them to your distribution.