Document new blanche exit status semantics. (Don't claim success

unless all adds and deletes succeeded.)

diff --git a/man/blanche.1 b/man/blanche.1
index 1563164a504b4886228fe02d2d00a0d9a6bdc3a2..51fc3874882992ea981c3ef08dfeded5cb61d59d 100644 (file)
--- a/man/blanche.1
+++ b/man/blanche.1
@@ -109,6 +109,14 @@ Mark Rosenstein and Jay Berkenbilt.
 .SH SEE ALSO
 listmaint(1)
 
+.SH DIAGNOSTICS
+The exit status from blanche is not as useful as you might hope. An
+exit status of 2 indicates a problem contacting the server or reading
+an input file. An exit status of 1 indicates that at least one add or
+delete failed, and an exit status of 0 indicates that all adds and
+deletes succeeded. If you need the exit status to be meaningful, you
+should only do one add or delete at a time.
+
 .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