Add an extra note at the end of the manpage, warning about the perils

of putting the listname anywhere other than as the first option.

Also, document the `-db/-database' option instead of the `-S/-server'
option, to match the moira client.

diff --git a/man/blanche.1 b/man/blanche.1
index e1ddbd31922db6be07e544b38e97aa380e151c42..1563164a504b4886228fe02d2d00a0d9a6bdc3a2 100644 (file)
--- a/man/blanche.1
+++ b/man/blanche.1
@@ -94,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:
@@ -108,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.