Skip to content

Commit 5e98940

Browse files
authored
fortune: document the -v flag (briandfoy#959)
* Mention -v version number option in the usage string and POD manual * Possibly the POD manual was copied from the NetBSD version, which doesn't have the -v option * As done for other scripts, remove manual word breaks in POD which don't render nicely under pod2text * Correct typos: "initial", "implementation"
1 parent 24c9f8d commit 5e98940

File tree

1 file changed

+24
-21
lines changed

1 file changed

+24
-21
lines changed

bin/fortune

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -954,7 +954,7 @@ sub print_help
954954

955955
print <<EOF;
956956
957-
Usage: $0 [-adefilosw] [-n length] [-m pattern] [[N%] file/dir/all]
957+
Usage: $0 [-adefilosvw] [-n length] [-m pattern] [[N%] file/dir/all]
958958
959959
See the POD for more information.
960960
@@ -968,6 +968,7 @@ Usage: $0 [-adefilosw] [-n length] [-m pattern] [[N%] file/dir/all]
968968
-o Choose only from potentially offensive aphorisms.
969969
-s Short apothegms only.
970970
-i Ignore case for -m patterns.
971+
-v Show version number.
971972
-w Wait before termination for a calculated amount of time.
972973
973974
all Same as the -a switch.
@@ -992,22 +993,22 @@ fortune - print a random, hopefully interesting, adage
992993
993994
=head1 SYNOPSIS
994995
995-
fortune [-adefilosw] [-n length] [-m pattern] [[N%] file/dir/all]
996+
fortune [-adefilosvw] [-n length] [-m pattern] [[N%] file/dir/all]
996997
997998
=head1 DESCRIPTION
998999
9991000
When fortune is run with no arguments it prints out a random epigram.
1000-
Epigrams are divided into several categories, where each category is sub-
1001-
divided into those which are potentially offensive and those which are
1001+
Epigrams are divided into several categories, where each category is
1002+
subdivided into those which are potentially offensive and those which are
10021003
not. The options are as follows:
10031004
10041005
-a Choose from all lists of maxims, both offensive and not. (See the
10051006
-o option for more information on offensive fortunes.)
10061007
10071008
-d Enable debug messages.
10081009
1009-
-e Consider all fortune files to be of equal size (see discussion be-
1010-
low on multiple files).
1010+
-e Consider all fortune files to be of equal size (see discussion
1011+
below on multiple files).
10111012
10121013
-f Print out the list of files which would be searched, but do not
10131014
print a fortune.
@@ -1027,13 +1028,13 @@ not. The options are as follows:
10271028
10281029
-o Choose only from potentially offensive aphorisms. Please, please,
10291030
please request a potentially offensive fortune if and only if you
1030-
believe, deep down in your heart, that you are willing to be of-
1031-
fended. (And that if you are, you'll just quit using -o rather
1031+
believe, deep down in your heart, that you are willing to be
1032+
offended. (And that if you are, you'll just quit using -o rather
10321033
than give us grief about it, okay?)
10331034
10341035
... let us keep in mind the basic governing philosophy of The
1035-
Brotherhood, as handsomely summarized in these words: we be-
1036-
lieve in healthy, hearty laughter -- at the expense of the
1036+
Brotherhood, as handsomely summarized in these words: we
1037+
believe in healthy, hearty laughter -- at the expense of the
10371038
whole human race, if needs be. Needs be.
10381039
--H. Allen Smith, "Rude Jokes"
10391040
@@ -1042,19 +1043,21 @@ not. The options are as follows:
10421043
10431044
-i Ignore case for -m patterns.
10441045
1046+
-v Show version number and exit.
1047+
10451048
-w Wait before termination for an amount of time calculated from the
1046-
number of characters in the message. This is useful if it is exe-
1047-
cuted as part of the logout procedure to guarantee that the message
1048-
can be read before the screen is cleared.
1049+
number of characters in the message. This is useful if it is
1050+
executed as part of the logout procedure to guarantee that the
1051+
message can be read before the screen is cleared.
10491052
10501053
The user may specify alternate sayings. You can specify a specific file,
10511054
a directory which contains one or more files, or the special word all
1052-
which says to use all the standard databases. Any of these may be pre-
1053-
ceded by a percentage, which is a number N between 0 and 100 inclusive,
1055+
which says to use all the standard databases. Any of these may be
1056+
preceded by a percentage, which is a number N between 0 and 100 inclusive,
10541057
followed by a %. If it is, there will be a N percent probability that an
10551058
adage will be picked from that file or directory. If the percentages do
1056-
not sum to 100, and there are specifications without percentages, the re-
1057-
maining percent will apply to those files and/or directories, in which
1059+
not sum to 100, and there are specifications without percentages, the
1060+
remaining percent will apply to those files and/or directories, in which
10581061
case the probability of selecting from one of them will be based on their
10591062
relative sizes.
10601063
@@ -1068,8 +1071,8 @@ not. The options are as follows:
10681071
fortune 90% funny 10% not-funny
10691072
10701073
will pick out 90% of its fortunes from funny (the ``10% not-funny'' is
1071-
unnecessary, since 10% is all that's left). The -e option says to con-
1072-
sider all files equal; thus
1074+
unnecessary, since 10% is all that's left). The -e option says to
1075+
consider all files equal; thus
10731076
10741077
fortune -e
10751078
@@ -1114,11 +1117,11 @@ Bundle files and possibly make an installer.
11141117
Dumped the -g option I tried in the original
11151118
11161119
Revision 1.0 1999/04/01 andy murren
1117-
Inital Revision
1120+
Initial Revision
11181121
11191122
=head1 AUTHOR
11201123
1121-
This Perl implmentation of I<fortune> was written by Andy Murren, I<[email protected]>.
1124+
This Perl implementation of I<fortune> was written by Andy Murren, I<[email protected]>.
11221125
11231126
=head1 COPYRIGHT and LICENSE
11241127

0 commit comments

Comments
 (0)