Make a half-hearted attempt at returning a useful exit status, instead

[moira.git] / man / blanche.1

diff --git a/man/blanche.1 b/man/blanche.1
index 89ee99e2e44d6ac1c2a81d93a6090309886c191f..1563164a504b4886228fe02d2d00a0d9a6bdc3a2 100644 (file)
--- a/man/blanche.1
+++ b/man/blanche.1
@@ -3,7 +3,7 @@
 .SH NAME
 blanche \- examine and modify memberships in Moira lists
 .SH SYNOPSIS
-.B blanche [options] listname [options]
+.B blanche listname [options]
 .SH DESCRIPTION
 .I Blanche
 is a tool for maintaining the membership of Moira lists.  It is more
@@ -53,6 +53,12 @@ will read from standard input.
 Display other information about the target list besides the
 membership.  This includes the description, flags, maillist and group
 status, owner, and last modification.
+.IP \fB-addlist\ \fIfilename\ \fRor\ \fB-al\ \fIfilename\fR:
+This will read a list of members from the named file, and add those
+members to the target list.  The file format is specified above.
+.IP \fB-deletelist\ \fIfilename\ \fRor\ \fB-dl\ \fIfilename\fR:
+This will read a list of members from the named file, and delete those
+members from the target list.  The file format is specified above.
 .IP \fB-members\ \fRor\ \fB-m\fR:
 Display the membership of the target list.  This is the default if no
 other options are specified.
@@ -69,7 +75,7 @@ Only display list members that are strings (not users or lists).  If
 none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all
 of them will be displayed.
 .IP \fB-kerberos\ \fRor\ \fB-k\fR:
-Only display list members that are kerberos principals (not users,
+Only display list members that are Kerberos principals (not users,
 lists, or strings).  If
 none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is
 specified, then all of them will be displayed.
@@ -88,11 +94,11 @@ member added or deleted.
 Do not attempt to perform Kerberos authentication with the Moira server.
 Retrieval operations on not-hidden lists are still possible without
 tickets.
-.IP \fB-server\ \fIhost:port\ \fRor\ \fB-S\ \fIhost:port\fR:
-Use the specified host and port to contact the Moira server instead of
+.IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR:
+Use the specified host and port to contact the Moira database instead of
 the default server.  Both may be symbolic names or numbers.  If the
 port is left off, the default Moira server port will be assumed.  The
-server chosen will be the one specified on the command line, specified
+database chosen will be the one specified on the command line, specified
 in the MOIRASERVER environment variable, the hesiod "moira" sloc entry,
 or the compiled in default, in that order or preference.
 .IP \fB-debug\ \fRor\ \fB-D\fR:
@@ -102,3 +108,8 @@ Turn on debugging messages.
 Mark Rosenstein and Jay Berkenbilt.
 .SH SEE ALSO
 listmaint(1)
+
+.SH NOTES
+The listname doesn't actually have to be the first argument, but if
+you put it anywhere else, it's easy to get the other arguments in the
+wrong order and do something other than what you intended.