Import my usual \dash macro into all these man pages, and use it for

[sgt/utils] / nntpid / nntpid.but

diff --git a/nntpid/nntpid.but b/nntpid/nntpid.but
index ee6f026..43fb488 100644 (file)
--- a/nntpid/nntpid.but
+++ b/nntpid/nntpid.but
@@ -1,10 +1,12 @@
 \cfg{man-identity}{nntpid}{1}{2004-11-21}{Simon Tatham}{Simon Tatham}
 
+\define{dash} \u2013{-}
+
 \title Man page for \cw{nntpid}
 
 \U NAME
 
-\cw{nntpid} - retrieve a single article from a news server
+\cw{nntpid} \dash retrieve a single article from a news server
 
 \U SYNOPSIS
 
@@ -40,9 +42,12 @@ that cause unexpected behaviour in your terminal. If \cw{nntpid}
 detects that its standard output is not a terminal, however, it will
 bypass the pager and just write out the article directly.
 
-There is an alternative mode of operation, enabled by the \cw{-a}
-option, in which \cw{nntpid} retrieves \e{all} available articles in
-the group and writes them to standard output in \cw{mbox} format.
+There are a couple of alternative mode of operation. In one, enabled
+by the \cw{-a} option, \cw{nntpid} retrieves \e{all} available
+articles in the group and writes them to standard output in \cw{mbox}
+format. In the other, enabled with \cw{-b}, \cw{nntpid} simply prints
+the lowest and highest article numbers currently available in that
+group from the news server.
 
 The location of the news server is obtained by reading the
 environment variable \cw{NNTPSERVER}, or failing that the file
@@ -103,6 +108,13 @@ straight to standard output without bothering to try using a pager.
 \cw{nntpid} will always write straight to standard output (so the
 \cw{-d} option is unnecessary).
 
+\dt \cw{-b}
+
+\dd Print the current bounds on that group's article numbers. The
+output is one line consisting of a minimum and maximum article number.
+(Not every article in that range will necessarily actually exist: a
+cancelled article will still use up a space in the numbering range.)
+
 \U AUTHENTICATION
 
 Currently, the only form of authentication supported by \cw{nntpid}