1 1.3 rillig # $NetBSD: Notes,v 1.3 2024/09/08 09:36:47 rillig Exp $ 2 1.2 cgd # @(#)Notes 8.1 (Berkeley) 5/31/93 3 1.2 cgd 4 1.1 cgd Warning: 5 1.1 cgd The fortunes contained in the fortune database have been collected 6 1.1 cgd haphazardly from a cacophony of sources, in number so huge it 7 1.1 cgd boggles the mind. It is impossible to do any meaningful quality 8 1.1 cgd control on attributions, or lack thereof, or exactness of the quote. 9 1.1 cgd Since this database is not used for profit, and since entire works 10 1.1 cgd are not published, it falls under fair use, as we understand it. 11 1.1 cgd However, if any half-assed idiot decides to make a profit off of 12 1.1 cgd this, they will need to double check it all, and nobody not involved 13 1.1 cgd of such an effort makes any warranty that anything in the database 14 1.1 cgd bears any relation to the real world of literature, law, or other 15 1.1 cgd bizzarrity. 16 1.1 cgd 17 1.1 cgd ==> GENERAL INFORMATION 18 1.1 cgd By default, fortune retrieves its fortune files from the directory 19 1.1 cgd /usr/share/games/fortune. A fortune file has two parts: the source file 20 1.1 cgd (which contains the fortunes themselves) and the data file which describes 21 1.1 cgd the fortunes. The data fil always has the same name as the fortune file 22 1.1 cgd with the string ".dat" concatenated, i.e. "fort" is the standard fortune 23 1.1 cgd database, and "fort.dat" is the data file which describes it. See 24 1.1 cgd strfile(8) for more information on creating the data files. 25 1.1 cgd Fortunes are split into potentially offensive and not potentially 26 1.1 cgd offensive parts. The offensive version of a file has the same name as the 27 1.1 cgd non-offensive version with "-o" concatenated, i.e. "fort" is the standard 28 1.1 cgd fortune database, and "fort-o" is the standard offensive database. The 29 1.1 cgd fortune program automatically assumes that any file with a name ending in 30 1.1 cgd "-o" is potentially offensive, and should therefore only be displayed if 31 1.1 cgd explicitly requested, either with the -o option or by specifying a file name 32 1.1 cgd on the command line. 33 1.1 cgd Potentially offensive fortune files should NEVER be maintained in 34 1.1 cgd clear text on the system. They are rotated (see caesar(6)) 13 positions. 35 1.1 cgd To create a new, potentially offensive database, use caesar to rotate it, 36 1.1 cgd and then create its data file with the -x option to strfile(8). The fortune 37 1.1 cgd program automatically decrypts the text when it prints entries from such 38 1.1 cgd databases. 39 1.1 cgd Anything which would not make it onto network prime time programming 40 1.1 cgd (or which would only be broadcast if some discredited kind of guy said it) 41 1.1 cgd MUST be in the potentially offensive database. Fortunes containing any 42 1.1 cgd explicit language (see George Carlin's recent updated list) MUST be in the 43 1.1 cgd potentially offensive database. Political and religious opinions are often 44 1.1 cgd sequestered in the potentially offensive section as well. Anything which 45 1.1 cgd assumes as a world view blatantly racist, mysogynist (sexist), or homophobic 46 1.1 cgd ideas should not be in either, since they are not really funny unless *you* 47 1.1 cgd are racist, mysogynist, or homophobic. 48 1.1 cgd The point of this is that people have should have a reasonable 49 1.1 cgd expectation that, should they just run "fortune", they will not be offended. 50 1.1 cgd We know that some people take offense at anything, but normal people do have 51 1.1 cgd opinions, too, and have a right not to have their sensibilities offended by 52 1.1 cgd a program which is supposed to be entertaining. People who run "fortune 53 1.1 cgd -o" or "fortune -a" are saying, in effect, that they are willing to have 54 1.1 cgd their sensibilities tweaked. However, they should not have their personal 55 1.1 cgd worth seriously (i.e., not in jest) assaulted. Jokes which depend for their 56 1.1 cgd humor on racist, mysogynist, or homophobic stereotypes *do* seriously 57 1.3 rillig assault individual personal worth, and in a general entertainment medium 58 1.1 cgd we should be able to get by without it. 59 1.1 cgd 60 1.1 cgd ==> FORMATTING 61 1.1 cgd This file describes the format for fortunes in the database. This 62 1.1 cgd is done in detail to make it easier to keep track of things. Any rule given 63 1.1 cgd here may be broken to make a better joke. 64 1.1 cgd 65 1.1 cgd [All examples are indented by one tab stop -- KCRCA] 66 1.1 cgd 67 1.1 cgd Numbers should be given in parentheses, e.g., 68 1.1 cgd 69 1.1 cgd (1) Everything depends. 70 1.1 cgd (2) Nothing is always. 71 1.1 cgd (3) Everything is sometimes. 72 1.1 cgd 73 1.1 cgd Attributions are two tab stops, followed by two hyphens, followed by a 74 1.1 cgd space, followed by the attribution, and are *not* preceded by blank 75 1.1 cgd lines. Book, journal, movie, and all other titles are in quotes, e.g., 76 1.1 cgd 77 1.1 cgd $100 invested at 7% interest for 100 years will become $100,000, at 78 1.1 cgd which time it will be worth absolutely nothing. 79 1.1 cgd -- Lazarus Long, "Time Enough for Love" 80 1.1 cgd 81 1.1 cgd Attributions which do not fit on one (72 char) line should be continued 82 1.1 cgd on a line which lines up below the first text of the attribution, e.g., 83 1.1 cgd 84 1.1 cgd -- A very long attribution which might not fit on one 85 1.1 cgd line, "Ken Arnold's Stupid Sayings" 86 1.1 cgd 87 1.1 cgd Single paragraph fortunes are in left justified (non-indented) paragraphs 88 1.1 cgd unless they fall into another category listed below (see example above). 89 1.1 cgd Longer fortunes should also be in left justified paragraphs, but if this 90 1.1 cgd makes it too long, try indented paragraphs, with indentations of either one 91 1.1 cgd tab stop or 5 chars. Indentations of less than 5 are too hard to read. 92 1.1 cgd 93 1.1 cgd Laws have the title left justified and capitalized, followed by a colon, 94 1.1 cgd with all the text of the law itself indented one tab stop, initially 95 1.1 cgd capitalized, e.g., 96 1.1 cgd 97 1.1 cgd A Law of Computer Programming: 98 1.1 cgd Make it possible for programmers to write in English and 99 1.1 cgd you will find the programmers cannot write in English. 100 1.1 cgd 101 1.1 cgd Limericks are indented as follows, all lines capitalized: 102 1.1 cgd 103 1.1 cgd A computer, to print out a fact, 104 1.1 cgd Will divide, multiply, and subtract. 105 1.1 cgd But this output can be 106 1.1 cgd No more than debris, 107 1.1 cgd If the input was short of exact. 108 1.1 cgd 109 1.1 cgd Accents precede the letter they are over, e.g., "`^He" for e with a grave 110 1.1 cgd accent. Underlining is done on a word-by-word basis, with the underlines 111 1.1 cgd preceding the word, e.g., "__^H^Hhi ____^H^H^H^Hthere". 112 1.1 cgd 113 1.1 cgd No fortune should run beyond 72 characters on a single line without good 114 1.1 cgd justification (er, no pun intended). And no right margin justification, 115 1.1 cgd either. Sorry. For BSD people, there is a program called "fmt" which can 116 1.1 cgd make this kind of formatting easier. 117 1.1 cgd 118 1.1 cgd Definitions are given with the word or phrase left justified, followed by 119 1.1 cgd the part of speech (if appropriate) and a colon. The definition starts 120 1.1 cgd indented by one tab stop, with subsequent lines left justified, e.g., 121 1.1 cgd 122 1.1 cgd Afternoon, n.: 123 1.1 cgd That part of the day we spend worrying about how we wasted 124 1.1 cgd the morning. 125 1.1 cgd 126 1.1 cgd Quotes are sometimes put around statements which are funnier or make more 127 1.1 cgd sense if they are understood as being spoken, rather than written, 128 1.1 cgd communication, e.g., 129 1.1 cgd 130 1.1 cgd "All my friends and I are crazy. That's the only thing that 131 1.1 cgd keeps us sane." 132 1.1 cgd 133 1.1 cgd Ellipses are always surrounded by spaces, except when next to punctuation, 134 1.1 cgd and are three dots long. 135 1.1 cgd 136 1.1 cgd "... all the modern inconveniences ..." 137 1.1 cgd -- Mark Twain 138 1.1 cgd 139 1.1 cgd Human initials always have spaces after the periods, e.g, "P. T. Barnum", 140 1.1 cgd not "P.T. Barnum". However, "P.T.A.", not "P. T. A.". 141 1.1 cgd 142 1.1 cgd All fortunes should be attributed, but if and only if they are original with 143 1.1 cgd somebody. Many people have said things that are folk sayings (i.e., are 144 1.1 cgd common among the folk (i.e., us common slobs)). There is nothing wrong with 145 1.1 cgd this, of course, but such statements should not be attributed to individuals 146 1.1 cgd who did not invent them. 147 1.1 cgd 148 1.1 cgd Horoscopes should have the sign indented by one tab stop, followed by the 149 1.1 cgd dates of the sign, with the text left justified below it, e.g., 150 1.1 cgd 151 1.1 cgd AQUARIUS (Jan 20 - Feb 18) 152 1.1 cgd You have an inventive mind and are inclined to be progressive. You 153 1.1 cgd lie a great deal. On the other hand, you are inclined to be 154 1.1 cgd careless and impractical, causing you to make the same mistakes over 155 1.1 cgd and over again. People think you are stupid. 156 1.1 cgd 157 1.1 cgd Single quotes should not be used except as quotes within quotes. Not even 158 1.1 cgd single quotes masquerading as double quotes are to be used, e.g., don't say 159 1.1 cgd ``hi there'' or `hi there' or 'hi there', but "hi there". However, you 160 1.1 cgd *can* say "I said, `hi there'". 161 1.1 cgd 162 1.1 cgd A long poem or song can be ordered as follows in order to make it fit on a 163 1.1 cgd screen (fortunes should be 19 lines or less if at all possible) (numbers 164 1.1 cgd here are stanza numbers): 165 1.1 cgd 166 1.1 cgd 11111111111111111111 167 1.1 cgd 11111111111111111111 168 1.1 cgd 11111111111111111111 22222222222222222222 169 1.1 cgd 11111111111111111111 22222222222222222222 170 1.1 cgd 22222222222222222222 171 1.1 cgd 33333333333333333333 22222222222222222222 172 1.1 cgd 33333333333333333333 173 1.1 cgd 33333333333333333333 44444444444444444444 174 1.1 cgd 33333333333333333333 44444444444444444444 175 1.1 cgd 44444444444444444444 176 1.1 cgd 44444444444444444444 177 1.1 cgd 178 1.1 cgd 179