Revise the markup.

This commit is contained in:
Ruslan Ermilov 2007-11-07 12:08:03 +00:00
parent d313ac6b41
commit b76be7efbf
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=173414

View File

@ -35,7 +35,7 @@
.\" @(#)fortune.6 8.3 (Berkeley) 4/19/94 .\" @(#)fortune.6 8.3 (Berkeley) 4/19/94
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 19, 1994 .Dd November 7, 2007
.Dt FORTUNE 6 .Dt FORTUNE 6
.Os .Os
.Sh NAME .Sh NAME
@ -57,7 +57,7 @@ Epigrams are divided into several categories, where each category
is subdivided into those which are potentially offensive and those is subdivided into those which are potentially offensive and those
which are not. which are not.
The options are as follows: The options are as follows:
.Bl -tag -width flag .Bl -tag -width indent
.It Fl a .It Fl a
Choose from all lists of maxims, both offensive and not. Choose from all lists of maxims, both offensive and not.
(See the (See the
@ -66,7 +66,8 @@ option for more information on offensive fortunes.)
.It Fl D .It Fl D
Enable additional debugging output. Enable additional debugging output.
Specify this option multiple times for more verbose output. Specify this option multiple times for more verbose output.
Only available if compiled with -DDEBUG. Only available if compiled with
.Li -DDEBUG .
.It Fl e .It Fl e
Consider all fortune files to be of equal size (see discussion below Consider all fortune files to be of equal size (see discussion below
on multiple files). on multiple files).
@ -75,7 +76,7 @@ Print out the list of files which would be searched, but do not
print a fortune. print a fortune.
.It Fl l .It Fl l
Long dictums only. Long dictums only.
.It Fl m .It Fl m Ar pattern
Print out all fortunes which match the regular expression Print out all fortunes which match the regular expression
.Ar pattern . .Ar pattern .
See See
@ -116,13 +117,13 @@ to guarantee that the message can be read before the screen is cleared.
The user may specify alternate sayings. The user may specify alternate sayings.
You can specify a specific file, a directory which contains one or You can specify a specific file, a directory which contains one or
more files, or the special word more files, or the special word
.Em all .Cm all
which says to use all the standard databases. which says to use all the standard databases.
Any of these may be preceded by a percentage, which is a number Any of these may be preceded by a percentage, which is a number
.Ar N .Ar N
between 0 and 100 inclusive, followed by a between 0 and 100 inclusive, followed by a
.Ar % . .Ql % .
If it is, there will be a If it is, there will be an
.Ar N .Ar N
percent probability that an adage will be picked from that file percent probability that an adage will be picked from that file
or directory. or directory.
@ -132,61 +133,56 @@ and/or directories, in which case the probability of selecting from
one of them will be based on their relative sizes. one of them will be based on their relative sizes.
.Pp .Pp
As an example, given two databases As an example, given two databases
.Em funny .Pa funny
and and
.Em not-funny , .Pa not-funny ,
with with
.Em funny .Pa funny
twice as big, saying twice as big, saying
.Bd -literal -offset indent .Pp
fortune funny not-funny .Dl "fortune funny not-funny"
.Ed
.Pp .Pp
will get you fortunes out of will get you fortunes out of
.Em funny .Pa funny
two-thirds of the time. two-thirds of the time.
The command The command
.Bd -literal -offset indent .Pp
fortune 90% funny 10% not-funny .Dl "fortune 90% funny 10% not-funny"
.Ed
.Pp .Pp
will pick out 90% of its fortunes from will pick out 90% of its fortunes from
.Em funny .Pa funny
(the (the
.Dq 10% not-funny .Dq Li "10% not-funny"
is unnecessary, since 10% is all that is left). is unnecessary, since 10% is all that is left).
The The
.Fl e .Fl e
option says to consider all files equal; option says to consider all files equal;
thus thus
.Bd -literal -offset indent .Pp
fortune -e funny not-funny .Dl "fortune -e funny not-funny"
.Ed
.Pp .Pp
is equivalent to is equivalent to
.Bd -literal -offset indent .Pp
fortune 50% funny 50% not-funny .Dl "fortune 50% funny 50% not-funny"
.Ed
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Bl -tag -width Pa -compact .Bl -tag -width ".Ev FORTUNE_PATH"
.It FORTUNE_PATH .It Ev FORTUNE_PATH
The search path for the data files. It is a colon-separated list The search path for the data files.
of directories in which It is a colon-separated list of directories in which
.Nm .Nm
looks for data files. If not set it will default to /usr/games/fortune. looks for data files.
If not set it will default to
.Pa /usr/games/fortune .
If none of the directories specified exist, it will print a warning and exit. If none of the directories specified exist, it will print a warning and exit.
.El .El
.Sh FILES .Sh FILES
.Bl -tag -width Pa -compact .Bl -tag -width ".Pa /usr/share/games/fortune/*"
.It Pa /usr/games/fortune .It Pa /usr/games/fortune
.Pp
.It Pa /usr/share/games/fortune/* .It Pa /usr/share/games/fortune/*
the fortunes databases (those files ending the fortunes databases (those files ending
.Dq -o .Dq Pa -o
contain the contain the
.Bf -symbolic .Sy offensive
offensive
.Ef
fortunes) fortunes)
.El .El
.Sh SEE ALSO .Sh SEE ALSO