X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=docs%2FREADME.config;h=645c22ad57be63a926ae4a98e597f72d1e9cb0e5;hb=ca1925d9291ec667f63dc6a895a3ac36fa9d6547;hp=1bd0b1d725c52f8f95472a00e880409ea57af9f8;hpb=c06f42046582ed68cdd7d51879d832dddeeed8d2;p=dak.git diff --git a/docs/README.config b/docs/README.config index 1bd0b1d7..645c22ad 100644 --- a/docs/README.config +++ b/docs/README.config @@ -1,5 +1,5 @@ -Explanation of configuration files options for katie -==================================================== +Explanation of configuration files options for dak +================================================== DB -- @@ -14,7 +14,7 @@ Essential. List of database details, e.g. | }; Name (required): The name of the PostgreSQL database which has been created -for katie. +for dak. Host (required): The name of the host on which the database is located. If the database is local, Host should be blank. @@ -33,7 +33,7 @@ Mandatory. List of directory locations, e.g. | { | Root "/org/ftp.debian.org/ftp/"; | Pool "/org/ftp.debian.org/ftp/pool/"; -| Templates "/org/ftp.debian.org/katie/templates/"; +| Templates "/org/ftp.debian.org/dak/templates/"; | PoolRoot "pool/"; | Override "/org/ftp.debian.org/scripts/override/"; | Lists "/org/ftp.debian.org/database/dists/"; @@ -56,29 +56,30 @@ Mandatory. List of directory locations, e.g. Root (required): Specifies the path of the root of the FTP archive. -Pool (required): This variable specifies the path of the pool directory. -Debian packages will be placed in the pool by kelly after they have been -accepted by jennifer. +Pool (required): This variable specifies the path of the pool +directory. Debian packages will be placed in the pool by 'dak +process-accepted' after they have been accepted by dak +process-unchecked. -Templates (required): katie sends various mails and uses templates from +Templates (required): dak sends various mails and uses templates from this directory. PoolRoot (required): This variable specifies the basename of the pool directory. Override (optional): This directory optionally stores override files (used -by denise). +by 'dak make-overrides'). Lists (optional): This directory holds file lists used by apt-ftparchive to -generate Packages and Sources files (used by jenna). +generate Packages and Sources files (used by 'dak make-suite-file-list'). Log (required): Log files are put in this directory. Morgue (required): Removed files are moved there. The morgue has various sub-directories, including (optionally) those defined by -Shania::MorgueSubDir and Rhona::MorgueSubDir. +Clean-Queues::MorgueSubDir and Clean-Suites::MorgueSubDir. -MorgueReject (required): if katie cannot move a rejected package to +MorgueReject (required): if dak cannot move a rejected package to Dir::Queue::Reject, it will try to move it to the Dir::MorgueReject directory located under Dir::Morgue. @@ -86,9 +87,9 @@ QueueBuild (optional): This variable is only relevant if any suites are to be auto built, i.e. if Dinstall::QueueBuildSuites has any values. -UrgencyLog (optional): If this directory is specified, kelly will store the -urgency value of each upload. This is mainly used for britney (the testing -script). +UrgencyLog (optional): If this directory is specified, 'dak +process-accepted' will store the urgency value of each upload. This +is mainly used for britney (the testing script). Queue (required): This sub-tree defines important directories for the incoming queue. The following variables have to be set: Accepted, Byhand @@ -130,28 +131,28 @@ Mandatory. List of all suites, e.g. Announce (optional): controls where "Installed foo" mails are sent. -CodeName, Origin and Description (optional): This settings are used by ziyi -and put in the Release files. +CodeName, Origin and Description (optional): This settings are used by +'dak generate-releases' and put in the Release files. -OverrideCodeName (optional): used by Denise. +OverrideCodeName (optional): used by 'dak make-overrides'. Priority (optional) determines which suite is used for the Maintainers file -as generated by charisma/da_mkmaintainers (highest wins). +as generated by 'dak make-maintainers' (highest wins). CopyChanges (optional): if this variable is present it should be a path into the archive (i.e. "Dir::RootDir"); any upload targeted for a suite with this config option present will have the .changes file copied into that path. -CopyKatie (optional): if this is present it should be an absolute path; any +CopyDotDak (optional): if this is present it should be an absolute path; any upload targeted for a suite with this config option present will have the -.katie file copied into that path. This option is similar to CopyChanges +.dak file copied into that path. This option is similar to CopyChanges and will most often be used with it; they're seperate because .changes -files are mirrored and .katie files aren't, so the paths will usually be +files are mirrored and .dak files aren't, so the paths will usually be different. There are more optional variables, such as VersionChecks. Please see -katie.conf for examples. +dak.conf for examples. ================================================================================ @@ -210,7 +211,7 @@ Mandatory. List of dinstall options, e.g.: | BugServer "bugs.debian.org"; | PackagesServer "packages.debian.org"; | TrackingServer "packages.qa.debian.org"; -| LockFile "/org/ftp.debian.org/katie/lock"; +| LockFile "/org/ftp.debian.org/dak/lock"; | Bcc "archive@ftp-master.debian.org"; | GroupOverrideFilename "override.group-maint"; | FutureTimeTravelGrace 28800; // 8 hours @@ -223,9 +224,10 @@ Mandatory. List of dinstall options, e.g.: | }; PGPKeyring and GPGKeyring (required): filenames of the PGP and GnuPG -keyrings to be used by katie respectively. +keyrings to be used by dak respectively. -SigningKeyring (optional): this is the private keyring used by ziyi. +SigningKeyring (optional): this is the private keyring used by 'dak +generate-releases'. SendmailCommand (required): command to call the MTA. @@ -235,16 +237,17 @@ as a script/daemon. MyAdminAddress (required): used as a contact address in mails. MyDistribution (required): this variable is used in emails sent out by -katie and others. It should indicate the name of the distribution. +dak and others. It should indicate the name of the distribution. -BugServer (required): is used by katie and melanie when closing bugs. +BugServer (required): is used by 'dak process-unchecked' and 'dak rm' +when closing bugs. -PackagesServer (requried): used by melanie when carbon-copying a bug close -mail to a package maintainer. +PackagesServer (requried): used by 'dak rm' when carbon-copying a bug +close mail to a package maintainer. -TrackingServer (optional): used by katie and melanie to send messages for -the maintainer also to an alias for people tracking a specific source -package. +TrackingServer (optional): used by 'dak process-unchecked' and 'dak +rm' to send messages for the maintainer also to an alias for people +tracking a specific source package. LockFile (required): contains the filename of the lockfile used by dinstall when in action mode (i.e. not using -n/--no-action). @@ -264,11 +267,11 @@ deciding whether or not to reject packages based on the file timestamp. BXANotify (optional): a boolean (default: no); if true (Debian-specific) BXA notification is sent. The template for the BXA notification is located -in Dir::Templates/lisa.bxa_notification and should be changed if this +in Dir::Templates/process-new.bxa_notification and should be changed if this option is set. OverrideDisparityCheck (optional): a boolean (default: no); if true, -jennifer compares an uploads section/priority with the overrides and whines +dak process-unchecked compares an uploads section/priority with the overrides and whines at the maintainer if they differ. CloseBugs (optional): a boolean (default: no); if true the automated bug @@ -285,7 +288,7 @@ __MAINTAINER_TO__ and __MAINTAINER_FROM__ variables in template mails. Use with caution. SkipTime (required): an integer value which is the number of seconds that a -file must be older than (via it's last modified timestamp) before jennifer +file must be older than (via it's last modified timestamp) before dak process-unchecked will REJECT rather than SKIP the package. ================================================================================ @@ -305,7 +308,7 @@ Mandatory. List of all archives, e.g. | }; | }; -OriginServer and PrimaryMirror (required): used melanie's bug closing mail +OriginServer and PrimaryMirror (required): used 'dak rm's bug closing mail templates. The host name and it's OriginServer and Description are part of the SQL database in the 'archive' table. @@ -428,7 +431,7 @@ Note that the archive value specified here must correspond to one defined in Archive. [Note: yes, this is horrible, it dates back to the original `import - the existent archive into the SQL Database' script (neve) and + the existent archive into the SQL Database' script ('dak import-archive') and isn't otherwise used. It should be revisted at some stage.] ================================================================================ @@ -455,7 +458,3 @@ This defines the valid and default urgency of an upload. If a package is uploaded with an urgency not listed here, it will be rejected. ================================================================================ - --- -James Troup , Horsforth, Leeds -Wed, 26 Sep 2001 03:20:39 +0100