Return to fortune.6 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / games / fortune

Annotation of 43BSDReno/games/fortune/fortune.6, revision 1.1

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.