NetBSD/games/wtf/wtf.6

.\"	$NetBSD: wtf.6,v 1.13 2009/05/04 20:37:28 wiz Exp $
.\"
.\" Public Domain
.\"
.Dd July 27, 2007
.Dt WTF 6
.Os
.Sh NAME
.Nm wtf
.Nd translates acronyms for you
.Sh SYNOPSIS
.Nm
.Op Fl f Ar dbfile
.Op Ar is
.Ar acronym Ar ...
.Sh DESCRIPTION
The
.Nm
utility displays the expansion of the acronyms
specified on the command line.
If the acronym is not in any of the acronyms databases,
.Nm
will check to see if the acronym is known by
.Xr whatis 1 ,
.Xr pkg_info 1 ,
or via pkgsrc's internal help mechanism,
.Dq make help topic=XXX .
.Pp
If
.Dq is
is specified on the command line, it will be ignored, allowing the
fairly natural
.Dq wtf is WTF
usage.
.Pp
The following options are available:
.Bl -tag -width flag
.It Fl f Ar dbfile
Overrides the default acronym database, bypassing the value of the
.Ev ACRONYMDB
variable.
.El
.Sh ENVIRONMENT
.Bl -tag -width ACRONYMDB
.It Ev ACRONYMDB
The default acronym database 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.
.El
.Sh SEE ALSO
.Xr make 1 ,
.Xr pkg_info 1 ,
.Xr whatis 1
.Sh HISTORY
.Nm
first appeared in
.Nx 1.5 .
Remove trailing whitespace. 2009-05-05 00:37:28 +04:00			`.\" $NetBSD: wtf.6,v 1.13 2009/05/04 20:37:28 wiz Exp $`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.\"`
			`.\" Public Domain`
			`.\"`
Teach wtf(6) about pkgsrc's help facility: % cd /usr/pkgsrc/audio/qsynth % wtf subst subst: ===> mk/subst.mk: # This Makefile fragment implements a general text replacement facility. ... 2007-08-07 01:14:36 +04:00			`.Dd July 27, 2007`
We're in section 6. 1999-07-26 00:02:48 +04:00			`.Dt WTF 6`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Os`
			`.Sh NAME`
			`.Nm wtf`
			`.Nd translates acronyms for you`
			`.Sh SYNOPSIS`
			`.Nm`
Implement the `-f' command line option to specify which acronyms database to use. Overrides ACRONYMDB's value, if given. 2003-04-10 13:18:24 +04:00			`.Op Fl f Ar dbfile`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Op Ar is`
			`.Ar acronym Ar ...`
			`.Sh DESCRIPTION`
			`The`
			`.Nm`
Whitespace and/or punctuation fixes. 2001-04-03 02:42:37 +04:00			`utility displays the expansion of the acronyms`
New sentences begin on new lines. Patch from Richard Elz, slightly improved by yours truly. 2002-09-26 20:12:39 +04:00			`specified on the command line.`
* Change program logic to not nest needlessly * Search all acronyms databases, and don't force the user to know in which category to look (-t is gone) * If an acronym is not found in the database or by whatis(1), also check pkg_info(1). Per PR bin/30539 by Geert Hendrickx (geert.hendrickx@ua.ac.be) OK'd by Julio M. Merino Vidal <jmmv> 2005-06-23 00:11:03 +04:00			`If the acronym is not in any of the acronyms databases,`
Check whatis(1) if we don't find an acronym matching the argument 1999-07-26 00:29:04 +04:00			`.Nm`
Remove trailing whitespace. 2009-05-05 00:37:28 +04:00			`will check to see if the acronym is known by`
Teach wtf(6) about pkgsrc's help facility: % cd /usr/pkgsrc/audio/qsynth % wtf subst subst: ===> mk/subst.mk: # This Makefile fragment implements a general text replacement facility. ... 2007-08-07 01:14:36 +04:00			`.Xr whatis 1 ,`
			`.Xr pkg_info 1 ,`
			`or via pkgsrc's internal help mechanism,`
			`.Dq make help topic=XXX .`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Pp`
			`If`
			`.Dq is`
			`is specified on the command line, it will be ignored, allowing the`
Whitespace and/or punctuation fixes. 2001-04-03 02:42:37 +04:00			`fairly natural`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Dq wtf is WTF`
			`usage.`
Implement the `-f' command line option to specify which acronyms database to use. Overrides ACRONYMDB's value, if given. 2003-04-10 13:18:24 +04:00			`.Pp`
			`The following options are available:`
			`.Bl -tag -width flag`
			`.It Fl f Ar dbfile`
			`Overrides the default acronym database, bypassing the value of the`
			`.Ev ACRONYMDB`
			`variable.`
			`.El`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Sh ENVIRONMENT`
			`.Bl -tag -width ACRONYMDB`
			`.It Ev ACRONYMDB`
			`The default acronym database may be overridden by setting the`
			`environment variable`
			`.Ev ACRONYMDB`
Fix typo or mispelling. 2006-06-17 08:58:14 +04:00			`to the name of one or more space-separated file names of`
* Change program logic to not nest needlessly * Search all acronyms databases, and don't force the user to know in which category to look (-t is gone) * If an acronym is not found in the database or by whatis(1), also check pkg_info(1). Per PR bin/30539 by Geert Hendrickx (geert.hendrickx@ua.ac.be) OK'd by Julio M. Merino Vidal <jmmv> 2005-06-23 00:11:03 +04:00			`acronym databases.`
Drop trailing space. 2005-06-26 14:07:23 +04:00			`The files must be in the proper format (acronym[tab]meaning).`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.El`
			`.Sh FILES`
Mention the /usr/share/misc/acronyms.comp database. 2003-04-11 15:13:34 +04:00			`.Bl -tag -width /usr/share/misc/acronyms.XXXX -compact`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.It Pa /usr/share/misc/acronyms`
			`default acronym database.`
Mention the /usr/share/misc/acronyms.comp database. 2003-04-11 15:13:34 +04:00			`.It Pa /usr/share/misc/acronyms.comp`
			`computer-related acronym database.`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.El`
Check whatis(1) if we don't find an acronym matching the argument 1999-07-26 00:29:04 +04:00			`.Sh SEE ALSO`
Teach wtf(6) about pkgsrc's help facility: % cd /usr/pkgsrc/audio/qsynth % wtf subst subst: ===> mk/subst.mk: # This Makefile fragment implements a general text replacement facility. ... 2007-08-07 01:14:36 +04:00			`.Xr make 1 ,`
* Change program logic to not nest needlessly * Search all acronyms databases, and don't force the user to know in which category to look (-t is gone) * If an acronym is not found in the database or by whatis(1), also check pkg_info(1). Per PR bin/30539 by Geert Hendrickx (geert.hendrickx@ua.ac.be) OK'd by Julio M. Merino Vidal <jmmv> 2005-06-23 00:11:03 +04:00			`.Xr pkg_info 1 ,`
Check whatis(1) if we don't find an acronym matching the argument 1999-07-26 00:29:04 +04:00			`.Xr whatis 1`
Allen Briggs' wtf(6) to grovel the acronyms database. 1999-07-22 05:03:20 +04:00			`.Sh HISTORY`
			`.Nm`
			`first appeared in`
			`.Nx 1.5 .`