Patrick Welche <prlw1@cam.ac.uk>
[netbsd-mini2440.git] / games / wtf / wtf.6
blobcc35879bcd9743d8e41c356dffea97e0bc884271
1 .\"     $NetBSD: wtf.6,v 1.12 2007/08/06 21:14:37 hubertf Exp $
2 .\"
3 .\" Public Domain
4 .\"
5 .Dd July 27, 2007
6 .Dt WTF 6
7 .Os
8 .Sh NAME
9 .Nm wtf
10 .Nd translates acronyms for you
11 .Sh SYNOPSIS
12 .Nm
13 .Op Fl f Ar dbfile
14 .Op Ar is
15 .Ar acronym Ar ...
16 .Sh DESCRIPTION
17 The
18 .Nm
19 utility displays the expansion of the acronyms
20 specified on the command line.
21 If the acronym is not in any of the acronyms databases,
22 .Nm
23 will check to see if the acronym is known by
24 .Xr whatis 1 ,
25 .Xr pkg_info 1 ,
26 or via pkgsrc's internal help mechanism,
27 .Dq make help topic=XXX .
28 .Pp
30 .Dq is
31 is specified on the command line, it will be ignored, allowing the
32 fairly natural
33 .Dq wtf is WTF
34 usage.
35 .Pp
36 The following options are available:
37 .Bl -tag -width flag
38 .It Fl f Ar dbfile
39 Overrides the default acronym database, bypassing the value of the
40 .Ev ACRONYMDB
41 variable.
42 .El
43 .Sh ENVIRONMENT
44 .Bl -tag -width ACRONYMDB
45 .It Ev ACRONYMDB
46 The default acronym database may be overridden by setting the
47 environment variable
48 .Ev ACRONYMDB
49 to the name of one or more space-separated file names of
50 acronym databases.
51 The files must be in the proper format (acronym[tab]meaning).
52 .El
53 .Sh FILES
54 .Bl -tag -width /usr/share/misc/acronyms.XXXX -compact
55 .It Pa /usr/share/misc/acronyms
56 default acronym database.
57 .It Pa /usr/share/misc/acronyms.comp
58 computer-related acronym database.
59 .El
60 .Sh SEE ALSO
61 .Xr make 1 ,
62 .Xr pkg_info 1 ,
63 .Xr whatis 1
64 .Sh HISTORY
65 .Nm
66 first appeared in
67 .Nx 1.5 .