home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Unix / Games / fortune / Source / fortune.0 < prev    next >
Encoding:
Text File  |  1994-05-13  |  3.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. FORTUNE(6)        UNIX Programmer's Manual           FORTUNE(6)
  5.  
  6.  
  7.  
  8. NAME
  9.      fortune - print a random, hopefully interesting, adage
  10.  
  11. SYNOPSIS
  12.      fortune [ -aefilosw ] [ -m _p_a_t_t_e_r_n ] [ [ _N% ] _f_i_l_e/_d_i_r/_a_l_l ]
  13.  
  14. DESCRIPTION
  15.      When _f_o_r_t_u_n_e is run with no arguments it prints out a random
  16.      epigram.  Epigrams are divided into several categories,
  17.      where each category is subdivided into those which are
  18.      potentially offensive and those which are not.  The options
  19.      are as follows:
  20.  
  21.      -a   Choose from all lists of maxims, both offensive and
  22.       not.
  23.  
  24.      -e   Consider all fortune files to be of equal size (see
  25.       discussion below on multiple files).
  26.  
  27.      -f   Print out the list of files which would be searched,
  28.       but don't print a fortune.
  29.  
  30.      -l   Long dictums only.
  31.  
  32.      -m   Print out all fortunes which match the regular expres-
  33.       sion _p_a_t_t_e_r_n.  See regex(3) for a description of pat-
  34.       terns.
  35.  
  36.      -o   Choose only from potentially offensive aphorisms.
  37.       Please, please, please request a potentially offensive
  38.       fortune if and only if you believe, deep down in your
  39.       heart, that you are willing to be offended.  (And that
  40.       if you are, you'll just quit using -o rather than give
  41.       us grief about it, okay?)
  42.  
  43.       ... let us keep in mind the basic governing philosophy
  44.       of The Brotherhood, as handsomely summarized in these
  45.       words: we believe in healthy, hearty laughter -- at the
  46.       expense of the whole human race, if needs be.  Needs
  47.       be.
  48.             -- H. Allen Smith, "Rude Jokes"
  49.  
  50.      -s   Short apothegms only.
  51.  
  52.      -i   Ignore case for -m patterns.
  53.  
  54.      -w   Wait before termination for an amount of time calcu-
  55.       lated from the number of characters in the message.
  56.       This is useful if it is executed as part of the logout
  57.       procedure to guarantee that the message can be read
  58.       before the screen is cleared.
  59.  
  60.      The user may specify alternate sayings.  You can specify a
  61.      specific file, a directory which contains one or more files,
  62.      or the special word all which says to use all the standard
  63.      databases.  Any of these may be preceded by a percentage,
  64.      which is a number _N between 0 and 100 inclusive, followed by
  65.      a % . If it is, there will be a _N percent probability that
  66.      an adage will be picked from that file or directory.  If the
  67.      percentages do not sum to 100, and there are specifications
  68.      without percentages, the remaining percent will apply to
  69.      those files and/or directories, in which case the probabil-
  70.      ity of selecting from one of them will be based on their
  71.      relative sizes.
  72.  
  73.      As an example, given two databases funny and not-funny ,
  74.      with funny twice as big, saying
  75.       fortune funny not-funny
  76.      will get you fortunes out of funny two-thirds of the time.
  77.      The command
  78.       fortune 90% funny 10% not-funny
  79.      will pick out 90% of its fortunes from funny (the ``10%
  80.      not-funny'' is unnecessary, since 10% is all that's left).
  81.      The -e option says to consider all files equal; thus
  82.       fortune -e
  83.      is equivalent to
  84.       fortune 50% funny 50% not-funny
  85.  
  86. FILES
  87.      /usr/local/lib/fortune
  88.  
  89. AUTHOR
  90.      Ken Arnold
  91.  
  92. SEE ALSO
  93.      regex(3), regcmp(3), strfile(8)
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.