]> git.decadent.org.uk Git - dak.git/blob - docs/README.first
Use len() to calculate the number of lines, not max() and only do it once.
[dak.git] / docs / README.first
1                                 Notes
2                                 =====
3
4 o Please be careful: katie sends out lots of emails and if not
5   configured properly will happily send them to lots of people who
6   probably didn't want those emails.
7
8 o Don't use katie.conf, apt.conf, cron.* etc. as starting points for
9   your own configuration files, they're the configuration files for
10   auric (aka ftp-master.debian.org) and are highly Debian specific.
11   Start from scratch and refer to the security.debian.org config files
12   (-security) as they're a better example for a private archive.
13
14 o Don't be put off by the names, see doc/README.names for a mapping of
15   name -> what the script does.
16
17                     What do all these scripts do?
18                     =============================
19
20 Generic and generally useful
21 ----------------------------
22
23 o To process queue/:
24
25   * jennifer - processes queue/unchecked
26   * kelly - processes queue/accepted
27   * lisa - processes queue/new and queue/byhand
28
29 o To generate indices files:
30
31   * jenna - generates file lists for apt-ftparchive and removes
32             obsolete packages from suites
33   * ziyi  - generates Release
34
35 o To clean things up:
36
37   * rhona - to remove obsolete files from the pool
38   * shania - to remove obsolete/stray files from the queue
39   * melanie - to remove package(s) from suite(s)
40
41 o Information display:
42
43   * madison - shows information about package(s)
44   * helena - shows information about package(s) in queue/
45
46 Generic and useful, but only for those with existing archives
47 -------------------------------------------------------------
48
49 o catherine - migrates packages from legacy locations to the pool
50 o neve - initializes a projectb database from an exisiting archive
51
52 Generic but not overly useful (in normal use)
53 ---------------------------------------------
54
55 o ashley - dumps info in .katie files
56 o julia - sync PostgreSQL users with system users
57 o rene - check for obsolete or duplicated packages
58 o rose - directory creation in the initial setup of an archive
59 o tea - various sanity checks of the database and archive
60 o natalie - manpiulates/list override entries
61 o heidi - removes/adds/lists package(s) from/to/for a suite
62 o saffron - produces various statistics
63 o rosamund - checks for users with no packages in the archive
64
65 Semi-generic
66 ------------
67
68 To generate less-used indices files:
69
70 o charisma - generates Maintainers file
71 o denise  - generates override.<foo> files
72
73 Mostly Debian(.org) specific
74 ----------------------------
75
76 o amber - wrapper for Debian security team
77 o halle - removes obsolete .changes files from proposed-updates
78 o jeri - basic dependency checking for proposed-updates
79 o emilie - syncs fingerprint and uid information with a debian.org LDAP DB
80 o lauren - manually reject packages from proposed-updates
81
82 Very Incomplete or otherwise not generally useful
83 -------------------------------------------------
84
85 o alyson - currently only initializes a DB from a katie.conf config file
86 o andrea - looks for version descrepancies that shouldn't exist in many
87            archives
88 o cindy - override cruft checker that doesn't work well with New Incoming
89
90 Scripts invoked by other scripts
91 --------------------------------
92
93 o fernanda - invoked by lisa to "check" NEW packages
94 o claire - invoked by catherine to determine packages still in legacy locations
95 o katie - common code used by lisa, jennifer, kelly and others
96
97                         How do I get started?
98                         =====================
99
100 [Very incomplete - FIXME]
101
102 o Write your own katie.conf and apt.conf files
103 o Run rose
104 o If you have an existing archive:
105    * Run neve
106   otherwise:
107    * Run alyson
108