sync

b618ca40 · James Troup · 20ef2ddf · b618ca40 · b618ca40 · 20ef2ddf
6 changed 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
--- a/docs/README.options
+++ b/docs/README.options
+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
--- a/docs/README.sourceless
+++ b/docs/README.sourceless
-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
--- a/docs/heidi.1.sgml
+++ b/docs/heidi.1.sgml
+<!-- -*- 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>
--- a/docs/julia.1.sgml
+++ b/docs/julia.1.sgml
+<!-- -*- 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>
--- a/docs/madison.1.sgml
+++ b/docs/madison.1.sgml
+<!-- -*- 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>