xref: /netbsd-src/games/wtf/wtf.6 (revision 6a960c88c2f84bb3e3d261f1a9cb3fda634dc1d7)
1*6a960c88Schristos.\"	$NetBSD: wtf.6,v 1.19 2015/04/22 15:04:57 christos Exp $
23fd86885Smrg.\"
33fd86885Smrg.\" Public Domain
43fd86885Smrg.\"
5*6a960c88Schristos.Dd April 22, 2015
62464b36eSthorpej.Dt WTF 6
73fd86885Smrg.Os
83fd86885Smrg.Sh NAME
93fd86885Smrg.Nm wtf
102de37ae3Sabs.Nd look up terms
113fd86885Smrg.Sh SYNOPSIS
123fd86885Smrg.Nm
13013854bdSjmmv.Op Fl f Ar dbfile
1496276379Schristos.Op Fl o
153fd86885Smrg.Op Ar is
162de37ae3Sabs.Ar term ...
173fd86885Smrg.Sh DESCRIPTION
183fd86885SmrgThe
193fd86885Smrg.Nm
202de37ae3Sabsutility looks up the meaning of one or more
212de37ae3Sabs.Ar term
222de37ae3Sabsoperands specified on the command line.
232de37ae3Sabs.Pp
242de37ae3Sabs.Ar term
252de37ae3Sabswill first be searched for as an acronym in the acronym databases,
264f7e551cSwizwhich are expected to be in the format
272de37ae3Sabs.Dq acronym[tab]meaning .
282de37ae3SabsIf no match has been found,
29b0412de8Sbriggs.Nm
302de37ae3Sabswill check to see if the term is known by
31e5fa46c7Shubertf.Xr whatis 1 ,
32e5fa46c7Shubertf.Xr pkg_info 1 ,
332de37ae3Sabsor, when called from within a pkgsrc package directory,
342de37ae3Sabspkgsrc's internal help facility,
35e5fa46c7Shubertf.Dq make help topic=XXX .
363fd86885Smrg.Pp
372de37ae3SabsThe optional
382de37ae3Sabs.Ar is
392de37ae3Sabsoperand will be ignored, allowing the
403fd86885Smrgfairly natural
413fd86885Smrg.Dq wtf is WTF
423fd86885Smrgusage.
43013854bdSjmmv.Pp
442de37ae3SabsThe following option is available:
45013854bdSjmmv.Bl -tag -width flag
46013854bdSjmmv.It Fl f Ar dbfile
474f7e551cSwizOverrides the default list of acronym databases, bypassing the value of the
48013854bdSjmmv.Ev ACRONYMDB
49013854bdSjmmvvariable.
504f7e551cSwizUnlike this variable the
514f7e551cSwiz.Fl f
524f7e551cSwizoption only accepts one file name as an argument,
534f7e551cSwizbut it may be given multiple times to specify more than one file to use.
5496276379Schristos.It Fl o
5596276379SchristosInclude acronyms that could be considered offensive to some.
5696276379SchristosPlease consult
57f290bb1cSwiz.Xr fortune 6
5896276379Schristosfor more information about the
5996276379Schristos.Fl o
6096276379Schristosflag.
61013854bdSjmmv.El
623fd86885Smrg.Sh ENVIRONMENT
633fd86885Smrg.Bl -tag -width ACRONYMDB
643fd86885Smrg.It Ev ACRONYMDB
654f7e551cSwizThe default list of acronym databases may be overridden by setting the
663fd86885Smrgenvironment variable
673fd86885Smrg.Ev ACRONYMDB
685fe28dc7Sreedto the name of one or more space-separated file names of
69e5a0b604Shubertfacronym databases.
703fd86885Smrg.El
713fd86885Smrg.Sh FILES
72bd6abf46Sjmmv.Bl -tag -width /usr/share/misc/acronyms.XXXX -compact
733fd86885Smrg.It Pa /usr/share/misc/acronyms
743fd86885Smrgdefault acronym database.
75*6a960c88Schristos.It Pa /usr/share/misc/acronyms-o
76*6a960c88Schristosdefault offensive acronym database.
77bd6abf46Sjmmv.It Pa /usr/share/misc/acronyms.comp
784f7e551cSwizdefault computer-related acronym database.
793fd86885Smrg.El
80b0412de8Sbriggs.Sh SEE ALSO
81e5fa46c7Shubertf.Xr make 1 ,
82e5a0b604Shubertf.Xr pkg_info 1 ,
8396276379Schristos.Xr whatis 1 ,
8496276379Schristos.Xr fortune 6
853fd86885Smrg.Sh HISTORY
863fd86885Smrg.Nm
873fd86885Smrgfirst appeared in
883fd86885Smrg.Nx 1.5 .
892de37ae3SabsInitially it only translated acronyms;
902de37ae3Sabsfunctionality to look up the meaning of terms in other sources was added later.
91