sync

diff --git a/README b/README
index 1e688489f901ec95b49f39259c7e10f6186bd46a..3d6ccf090b4b96637739f4ebb3facc2bef06364d 100644 (file)
--- a/README
+++ b/README
@@ -18,7 +18,7 @@ See the file INSTALL for installation instructions.
 dak is used on the following platforms :-
 
 Linux/i386 2.2
-Linux/UltraSparc 2.2
+Linux/Sparc 2.4
 
 dak is free software; you can redistribute it and/or modify it under
 the terms of the GNU General Public License as published by the Free
@@ -28,6 +28,7 @@ version.
 
 -- 
 James Troup <james@nocrew.org>, Horsforth, Leeds
-Wed, 21 Mar 2001 06:35:18 +0000
+Wed, 26 Sep 2001 06:34:50 +0100
+
 
 

diff --git a/docs/README.options b/docs/README.options
new file mode 100644 (file)
index 0000000..74789fc
--- /dev/null
+++ b/docs/README.options
@@ -0,0 +1,13 @@
+Standard options
+----------------
+
+-a/--architectures
+-c/--component
+-h/--help 
+-n/--no-action
+-s/--suite
+-V/--version
+
+Exceptions:
+  katie - backwardly compatible options with dinstall
+  heidi - ? hysterical raisins and testing compatibility

diff --git a/docs/README.sourceless b/docs/README.sourceless
deleted file mode 100644 (file)
index e877850..0000000
--- a/docs/README.sourceless
+++ /dev/null
@@ -1,39 +0,0 @@
-To: ftpmaster@debian.org
-Subject: binary-less source-only packages
-Mail-Copies-To: never
-Gcc: nnfolder+archive:2000/mail-12-December
---text follows this line--
-Hi,
-
-katie does reference counting of binaries and any source package which
-isn't referenced by a binary package is automatically deleted.  This:
-
- o allows us to stop violating the GPL.
-
- o ensures that the source for any binary package is always available;
-   nice for build problems on non-i386 arches.
-
- o reduces manual work in cleaning out cruft from the archive as
-   packages where the source name has changed will be automatically
-   cleaned out.
-
-The only problem is intentionally binary-less packages.  The only
-valid occurrence I can think of is pine, but in case there are more
-I've added an override for such files in:
-
-  /org/<host>.debian.org/scripts/override/override.source-only
-
-If you process an intentionally binary-less package in incoming and
-determine it's binary-less state is valid; please add the package to
-the override file.
-
-If I've missed any packages and people are screaming about their
-removal, you can recover them from:
-
-  /org/<host>.debian.org/morgue/rhona/
-
-As to how to add them back into the pool.. ho hum.. have to write
-something to do that :-)
-
--- 
-James

diff --git a/docs/heidi.1.sgml b/docs/heidi.1.sgml
new file mode 100644 (file)
index 0000000..8ff32df
--- /dev/null
+++ b/docs/heidi.1.sgml
@@ -0,0 +1,82 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % katieent SYSTEM "katie.ent">
+%katieent;
+
+]>
+
+<refentry>
+  &katie-docinfo;
+
+  <refmeta>
+    <refentrytitle>heidi</>
+    <manvolnum>1</>
+  </refmeta>
+
+  <!-- Man page title -->
+  <refnamediv>
+    <refname>heidi</>
+    <refpurpose>Utility to alter or display the contents of a suite</>
+  </refnamediv>
+
+  <!-- Arguments -->
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>heidi</>
+      <arg><option><replaceable>options</replaceable></></arg>
+      <arg choice="plain"><replaceable>file...</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <RefSect1><Title>Description</>
+    <para>
+      <command>heidi</command> is a utility to alter or display the contents of a suite.  Input for alterations is taken either from filename(s) supplied or stdin.  The format for both input and output is lines each with a whitespace separated list of: <literal>package</literal>, <literal>version</literal> and <literal>architecture</literal>.
+    </PARA>
+  </REFSECT1>
+
+  <RefSect1><Title>Options</>
+
+    <VariableList>
+      <VarListEntry><term><option>-a/--add=<replaceable>suite</replaceable></option></>
+       <ListItem>
+         <Para>Add to the suite.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-l/--list=<replaceable>suite</replaceable></option></>
+       <ListItem>
+         <Para>List the contents of the suite.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-r/--remove=<replaceable>suite</replaceable></option></>
+       <ListItem>
+         <Para>Remove from the suite.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-s/--set=<replaceable>suite</replaceable></option></>
+       <ListItem>
+         <Para>Set the suite to exactly the input.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-h/--help</option></>
+       <ListItem>
+         <Para>Show help and then exit.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+    </VariableList>
+  </RefSect1>
+
+  <RefSect1><Title>Diagnostics</>
+    <para>
+      <command>heidi</command> returns zero on normal operation, non-zero on error.
+    </PARA>
+  </RefSect1>
+
+  &manauthor;
+
+</refentry>

diff --git a/docs/julia.1.sgml b/docs/julia.1.sgml
new file mode 100644 (file)
index 0000000..268ea69
--- /dev/null
+++ b/docs/julia.1.sgml
@@ -0,0 +1,89 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % katieent SYSTEM "katie.ent">
+%katieent;
+
+]>
+
+<refentry>
+  &katie-docinfo;
+
+  <refmeta>
+    <refentrytitle>julia</>
+    <manvolnum>1</>
+  </refmeta>
+
+  <!-- Man page title -->
+  <refnamediv>
+    <refname>julia</>
+    <refpurpose>Utility to sync PostgreSQL with a (LDAP-generated) passwd file</>
+  </refnamediv>
+
+  <!-- Arguments -->
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>julia</>
+      <arg><option><replaceable>options</replaceable></></arg>
+      <arg choice="plain"><replaceable>passwd file</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <RefSect1><Title>Description</>
+    <para>
+      <command>julia</command> is a utility to sync PostgreSQL's user database with a passwd file.  It is designed to allow the use of 'peer sameuser' authentication.  It simply adds any users in the password file into PostgreSQL's pg_user table if they are already not there.  It will also warn you about users who are in the pg_user table but not in the password file.
+    </PARA>
+  </REFSECT1>
+
+  <RefSect1><Title>Options</>
+
+    <VariableList>
+      <VarListEntry><term><option>-q/--quiet<replaceable></replaceable></option></>
+       <ListItem>
+         <Para>Be quiet, i.e. display as little output as possible.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-v/--verbose</option></>
+       <ListItem>
+         <Para>Be verbose, i.e. display more output than normal.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-h/--help</option></>
+       <ListItem>
+         <Para>Show help and then exit.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+    </VariableList>
+  </RefSect1>
+
+  <refsect1>
+    <title>Configuration</title>
+    <para><command>julia</command> uses katie's configuration file. It follows the typical ISC configuration format as seen in ISC tools like bind 8 and dhcpd.  Apart from being able to alter the defaults for command line options, the following configuration items are used:</para>
+    <variablelist>
+      <varlistentry>
+       <term>Julia::ValidGID</term>
+       <listitem>
+         <para>Each user's primary GID is compared with this, if it's not blank.  If they match, the user will be processed, if they don't, the user will be skipped.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Julia::KnownPostgresUsers</term>
+       <listitem>
+         <para>This is a comma-separated list of users who are in PostgreSQL's pg_user table but are not in the password file.</para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <RefSect1><Title>Diagnostics</>
+    <para>
+      <command>julia</command> returns zero on normal operation, non-zero on error.
+    </PARA>
+  </RefSect1>
+
+  &manauthor;
+
+</refentry>

diff --git a/docs/madison.1.sgml b/docs/madison.1.sgml
new file mode 100644 (file)
index 0000000..d65c872
--- /dev/null
+++ b/docs/madison.1.sgml
@@ -0,0 +1,70 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % katieent SYSTEM "katie.ent">
+%katieent;
+
+]>
+
+<refentry>
+  &katie-docinfo;
+
+  <refmeta>
+    <refentrytitle>madison</>
+    <manvolnum>1</>
+  </refmeta>
+
+  <!-- Man page title -->
+  <refnamediv>
+    <refname>madison</>
+    <refpurpose>Utility to display information about packages</>
+  </refnamediv>
+
+  <!-- Arguments -->
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>madison</>
+      <arg><option><replaceable>options</replaceable></></arg>
+      <arg choice="plain"><replaceable>package</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <RefSect1><Title>Description</>
+    <para>
+      <command>madison</command> is a utility to display information about packages, specificaly what suites they are in and for which architectures.
+    </PARA>
+  </REFSECT1>
+
+  <RefSect1><Title>Options</>
+
+    <VariableList>
+      <VarListEntry><term><option>-a/--architecture=<replaceable>architecture</replaceable></option></>
+       <ListItem>
+         <Para>Restrict the packages being considered to the architecture(s) listed.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-s/--suite=<replaceable>suite</replaceable></option></>
+       <ListItem>
+         <Para>Only list package information for the suite(s) listed.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+      <VarListEntry><term><option>-h/--help</option></>
+       <ListItem>
+         <Para>Show help and then exit.</PARA>
+       </LISTITEM>
+      </VarListEntry>
+
+    </VariableList>
+  </RefSect1>
+
+  <RefSect1><Title>Diagnostics</>
+    <para>
+      <command>madison</command> returns zero on normal operation, non-zero on error.
+    </PARA>
+  </RefSect1>
+
+  &manauthor;
+
+</refentry>