[src/trunk]: src/games/wtf - improve wording and overall program description ...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/dd8699e30671
branches:  trunk
changeset: 781850:dd8699e30671
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Oct 03 19:50:11 2012 +0000

description:
- improve wording and overall program description (notably for `-f');
- improve macro usage;
- bump date.

>From Bug Hunting.

diffstat:

 games/wtf/wtf.6 |  27 ++++++++++++++++-----------
 1 files changed, 16 insertions(+), 11 deletions(-)

diffs (73 lines):

diff -r ad18964a72e4 -r dd8699e30671 games/wtf/wtf.6
--- a/games/wtf/wtf.6   Wed Oct 03 19:50:06 2012 +0000
+++ b/games/wtf/wtf.6   Wed Oct 03 19:50:11 2012 +0000
@@ -1,26 +1,28 @@
-.\"    $NetBSD: wtf.6,v 1.13 2009/05/04 20:37:28 wiz Exp $
+.\"    $NetBSD: wtf.6,v 1.14 2012/10/03 19:50:11 wiz Exp $
 .\"
 .\" Public Domain
 .\"
-.Dd July 27, 2007
+.Dd September 25, 2012
 .Dt WTF 6
 .Os
 .Sh NAME
 .Nm wtf
-.Nd translates acronyms for you
+.Nd translate acronyms
 .Sh SYNOPSIS
 .Nm
 .Op Fl f Ar dbfile
 .Op Ar is
-.Ar acronym Ar ...
+.Ar acronym ...
 .Sh DESCRIPTION
 The
 .Nm
-utility displays the expansion of the acronyms
+utility displays the expansion of one or more acronyms
 specified on the command line.
-If the acronym is not in any of the acronyms databases,
+If an acronym is not in any of the acronym databases,
+which are expected to be in the format
+.Dq acronym[tab]meaning ,
 .Nm
-will check to see if the acronym is known by
+will check to see if it is known by
 .Xr whatis 1 ,
 .Xr pkg_info 1 ,
 or via pkgsrc's internal help mechanism,
@@ -36,26 +38,29 @@
 The following options are available:
 .Bl -tag -width flag
 .It Fl f Ar dbfile
-Overrides the default acronym database, bypassing the value of the
+Overrides the default list of acronym databases, bypassing the value of the
 .Ev ACRONYMDB
 variable.
+Unlike this variable the
+.Fl f
+option only accepts one file name as an argument,
+but it may be given multiple times to specify more than one file to use.
 .El
 .Sh ENVIRONMENT
 .Bl -tag -width ACRONYMDB
 .It Ev ACRONYMDB
-The default acronym database may be overridden by setting the
+The default list of acronym databases may be overridden by setting the
 environment variable
 .Ev ACRONYMDB
 to the name of one or more space-separated file names of
 acronym databases.
-The files must be in the proper format (acronym[tab]meaning).
 .El
 .Sh FILES
 .Bl -tag -width /usr/share/misc/acronyms.XXXX -compact
 .It Pa /usr/share/misc/acronyms
 default acronym database.
 .It Pa /usr/share/misc/acronyms.comp
-computer-related acronym database.
+default computer-related acronym database.
 .El
 .Sh SEE ALSO
 .Xr make 1 ,