wtf/wtf.6

   1 .\"     $NetBSD: wtf.6,v 1.15 2012/10/03 19:50:43 wiz Exp $
   2 .\"
   3 .\" Public Domain
   4 .\"
   5 .Dd October 3, 2012
   6 .Dt WTF 6
   7 .Os
   8 .Sh NAME
   9 .Nm wtf
  10 .Nd translate acronyms
  11 .Sh SYNOPSIS
  12 .Nm
  13 .Op Fl f Ar dbfile
  14 .Op Ar is
  15 .Ar acronym ...
  16 .Sh DESCRIPTION
  17 The
  18 .Nm
  19 utility displays the expansion of one or more acronyms
  20 specified on the command line.
  21 If an acronym is not in any of the acronym databases,
  22 which are expected to be in the format
  23 .Dq acronym[tab]meaning ,
  24 .Nm
  25 will check to see if it is known by
  26 .Xr whatis 1 ,
  27 .Xr pkg_info 1 ,
  28 or via pkgsrc's internal help mechanism,
  29 .Dq make help topic=XXX .
  30 .Pp
  31 If
  32 .Dq is
  33 is specified on the command line, it will be ignored, allowing the
  34 fairly natural
  35 .Dq wtf is WTF
  36 usage.
  37 .Pp
  38 The following options are available:
  39 .Bl -tag -width flag
  40 .It Fl f Ar dbfile
  41 Overrides the default list of acronym databases, bypassing the value of the
  42 .Ev ACRONYMDB
  43 variable.
  44 Unlike this variable the
  45 .Fl f
  46 option only accepts one file name as an argument,
  47 but it may be given multiple times to specify more than one file to use.
  48 .El
  49 .Sh ENVIRONMENT
  50 .Bl -tag -width ACRONYMDB
  51 .It Ev ACRONYMDB
  52 The default list of acronym databases may be overridden by setting the
  53 environment variable
  54 .Ev ACRONYMDB
  55 to the name of one or more space-separated file names of
  56 acronym databases.
  57 .El
  58 .Sh FILES
  59 .Bl -tag -width /usr/share/misc/acronyms.XXXX -compact
  60 .It Pa /usr/share/misc/acronyms
  61 default acronym database.
  62 .It Pa /usr/share/misc/acronyms.comp
  63 default computer-related acronym database.
  64 .El
  65 .Sh SEE ALSO
  66 .Xr make 1 ,
  67 .Xr pkg_info 1 ,
  68 .Xr whatis 1
  69 .Sh HISTORY
  70 .Nm
  71 first appeared in
  72 .Nx 1.5 .