Module Name: src
Committed By: wiz
Date: Wed Oct 3 19:50:11 UTC 2012
Modified Files:
src/games/wtf: wtf.6
Log Message:
- improve wording and overall program description (notably for `-f');
- improve macro usage;
- bump date.
>From Bug Hunting.
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/games/wtf/wtf.6
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/games/wtf/wtf.6
diff -u src/games/wtf/wtf.6:1.13 src/games/wtf/wtf.6:1.14
--- src/games/wtf/wtf.6:1.13 Mon May 4 20:37:28 2009
+++ src/games/wtf/wtf.6 Wed Oct 3 19:50:11 2012
@@ -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 @@ usage.
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 ,
