![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to fortune.6 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / games / fortune|
Return to fortune.6 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / games / fortune |
1.1 root 1: .\" Copyright (c) 1985 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" This code is derived from software contributed to Berkeley by
5: .\" Ken Arnold.
6: .\"
7: .\" Redistribution and use in source and binary forms are permitted provided
8: .\" that: (1) source distributions retain this entire copyright notice and
9: .\" comment, and (2) distributions including binaries display the following
10: .\" acknowledgement: ``This product includes software developed by the
11: .\" University of California, Berkeley and its contributors'' in the
12: .\" documentation or other materials provided with the distribution and in
13: .\" all advertising materials mentioning features or use of this software.
14: .\" Neither the name of the University nor the names of its contributors may
15: .\" be used to endorse or promote products derived from this software without
16: .\" specific prior written permission.
17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20: .\"
21: .\" @(#)fortune.6 6.8 (Berkeley) 6/23/90
22: .\"
23: .TH FORTUNE 6 "June 23, 1990"
24: .UC 4
25: .SH NAME
26: fortune \- print a random, hopefully interesting, adage
27: .SH SYNOPSIS
28: .B fortune
29: [
30: .B \-aefilosw
31: ]
32: [
33: .B \-m
34: .I pattern
35: ]
36: [ [
37: .IR N%
38: ]
39: .I file/dir/all
40: ]
41: .SH DESCRIPTION
42: When
43: .I fortune
44: is run with no arguments it prints out a random epigram.
45: Epigrams are divided into several categories, where each category
46: is subdivided into those which are potentially offensive and those
47: which are not.
48: The options are as follows:
49: .TP
50: .B \-a
51: Choose from all lists of maxims, both offensive and not.
52: .TP
53: .B \-e
54: Consider all fortune files to be of equal size (see discussion below
55: on multiple files).
56: .TP
57: .B \-f
58: Print out the list of files which would be searched, but don't
59: print a fortune.
60: .TP
61: .B \-l
62: Long dictums only.
63: .TP
64: .B \-m
65: Print out all fortunes which match the regular expression
66: .IR pattern .
67: See
68: .BR regex (3)
69: for a description of patterns.
70: .TP
71: .B \-o
72: Choose only from potentially offensive aphorisms.
73: .ft B
74: Please, please, please request a potentially offensive fortune if and
75: only if you believe, deep down in your heart, that you are willing
76: to be offended.
77: (And that if you are, you'll just quit using -o rather than give us
78: grief about it, okay?)
79: .ft R
80: .PP
81: .in +5
82: \&... let us keep in mind the basic governing philosophy
83: of The Brotherhood, as handsomely summarized in these words:
84: we believe in healthy, hearty laughter -- at the expense of
85: the whole human race, if needs be.
86: Needs be.
87: .br
88: .in +10
89: -- H. Allen Smith, "Rude Jokes"
90: .TP
91: .B \-s
92: Short apothegms only.
93: .TP
94: .B \-i
95: Ignore case for
96: .B \-m
97: patterns.
98: .TP
99: .B \-w
100: Wait before termination for an amount of time calculated from the
101: number of characters in the message.
102: This is useful if it is executed as part of the logout procedure
103: to guarantee that the message can be read before the screen is cleared.
104: .PP
105: The user may specify alternate sayings.
106: You can specify a specific file, a directory which contains one or
107: more files, or the special word
108: .B all
109: which says to use all the standard databases.
110: Any of these may be preceded by a percentage, which is a number
111: .I N
112: between 0 and 100 inclusive, followed by a
113: .B % .
114: If it is, there will be a
115: .I N
116: percent probability that an adage will be picked from that file
117: or directory.
118: If the percentages do not sum to 100, and there are specifications
119: without percentages, the remaining percent will apply to those files
120: and/or directories, in which case the probability of selecting from
121: one of them will be based on their relative sizes.
122: .PP
123: As an example, given two databases
124: .B funny
125: and
126: .B not-funny ,
127: with
128: .B funny
129: twice as big, saying
130: .RS
131: fortune funny not-funny
132: .RE
133: will get you fortunes out of
134: .B funny
135: two-thirds of the time.
136: The command
137: .RS
138: fortune 90% funny 10% not-funny
139: .RE
140: will pick out 90% of its fortunes from
141: .B funny
142: (the ``10% not-funny'' is unnecessary, since 10% is all that's left).
143: The
144: .B \-e
145: option says to consider all files equal;
146: thus
147: .RS
148: fortune \-e
149: .RE
150: is equivalent to
151: .RS
152: fortune 50% funny 50% not-funny
153: .RE
154: .SH FILES
155: /usr/share/games/fortune
156: .SH AUTHOR
157: Ken Arnold
158: .SH "SEE ALSO"
159: regex(3), regcmp(3), strfile(8)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.