From b618ca40333f46edada83f0329f85cec83bca7eb Mon Sep 17 00:00:00 2001 From: James Troup Date: Thu, 27 Sep 2001 00:56:47 +0000 Subject: [PATCH] sync --- README | 5 ++- docs/README.options | 13 ++++++ docs/README.sourceless | 39 ------------------ docs/heidi.1.sgml | 82 ++++++++++++++++++++++++++++++++++++++ docs/julia.1.sgml | 89 ++++++++++++++++++++++++++++++++++++++++++ docs/madison.1.sgml | 70 +++++++++++++++++++++++++++++++++ 6 files changed, 257 insertions(+), 41 deletions(-) create mode 100644 docs/README.options delete mode 100644 docs/README.sourceless create mode 100644 docs/heidi.1.sgml create mode 100644 docs/julia.1.sgml create mode 100644 docs/madison.1.sgml diff --git a/README b/README index 1e688489..3d6ccf09 100644 --- 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 , 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 index 00000000..74789fc6 --- /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 index e8778508..00000000 --- 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/.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/.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 index 00000000..8ff32df4 --- /dev/null +++ b/docs/heidi.1.sgml @@ -0,0 +1,82 @@ + + +%katieent; + +]> + + + &katie-docinfo; + + + heidi + 1 + + + + + heidi + Utility to alter or display the contents of a suite + + + + + + heidi + + file... + + + + 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 index 00000000..268ea690 --- /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 + julia 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: + + + Julia::ValidGID + + 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. + + + + Julia::KnownPostgresUsers + + This is a comma-separated list of users who are in PostgreSQL's pg_user table but are not in the password file. + + + + + + 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 index 00000000..d65c872f --- /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> -- 2.39.2