]> granicus.if.org Git - fortune-mod/blob - fortune-mod/README
prepare for a new release
[fortune-mod] / fortune-mod / README
1 fortune-mod README
2 ==================
3
4 This is fortune-mod. It now lives at:
5
6 * https://github.com/shlomif/fortune-mod
7
8 * http://www.shlomifish.org/open-source/projects/fortune-mod/
9
10 It is based on fortune-mod-1.99.1 with many improvements.
11
12     -- Shlomi Fish
13
14 Old README
15 ==========
16
17 This is fortune-mod-1.99.1. It's a pre-release for
18 fortune-mod-2.0. This should give interested parties a chance to have
19 a look at the changes that have come in, and the new features.
20
21 Fortune-mod now leaves at http://www.redellipse.net/code/fortune. You
22 can find the CVS repository at
23 http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/fortune/?cvsroot=fortune
24
25 Many thanks to Dennis for making the last release of this software,
26 and to everyone who has taken the time to contribute quotes. We are
27 now up to 22203 fortunes at last count. Keep 'em coming!
28
29         -- Pascal Hakim <pasc@redellipse.net> Fri, 05 Mar 2004 23:03:00 +1100
30
31 --- Dennis' README---
32 fortune-mod README
33 ==================
34
35 This is fortune-mod 9708.  It is basically the same as the fortune-mod
36 released in October 1995, with some portability improvements, bug fixes
37 and documentation cleanup.
38
39 The most significant fix was for the reported bug about the `-a' option
40 of fortune with database names that appear in both the inoffensive and
41 offensive directories.  This was solved by allowing the user to append
42 '-o' to a fortune name while `-a' is in effect to force selection of the
43 offensive version of a database.
44
45 Other changes/fixes: Fortune is now consistent in how it determines a
46 fortune's length (for -s and -l).  The -m can now be used together with
47 -s or -l: only fortunes which match _BOTH_ the pattern and the length
48 requirement will be printed.
49
50 Most of the other features over the usual BSD fortune are summarised in
51 Amy's README.Linux, included below, and in the accompanying manual pages
52 for fortune(6) and strfile(1).
53
54 The changes in fortune.c and fortune.man are copyrighted by me but
55 freely distributable: see the source files for details.  All other
56 changes are in the public domain: you may do what you like with them.
57
58 Getting this Software
59 ---------------------
60
61 You can find out about my latest version of this package from my
62 Software Hacks web page:
63
64     http://www.progsoc.uts.edu.au/~dbugger/hacks/hacks.html
65
66 From it, there are links to download the source code.
67
68 I shall also be uploading "stable" releases to the SunSITE Linux mirror
69 network, so check out sunsite.unc.edu or your local SunSITE mirror. If
70 you still can't find it, the package should be registered under the
71 Linux Software Map, at:
72
73     http://www.execpc.com/lsm/
74
75 Its LSM entry should tell you where to find it.
76
77 Cheers,
78
79
80   -- Dennis L. Clark <dbugger@progsoc.uts.edu.au>  Thu, 28 Aug 1997 11:42:15 -0400
81
82 ----Amy's README.Linux---
83 This version of fortune is a modification of the NetBSD fortune, as
84 tweaked by Florian La Roche (see below, and many thanks to Florian for
85 starting the update), and then massively hacked on by Amy Lewis.
86
87 I (Amy) hacked on this because it was broken; the BSD source itself is
88 broken (I looked at it).  Specifically, if you are using an old version
89 of fortune, then it accesses *only* the two files "fortunes" and
90 "fortunes-o", even though 'fortune -[ao]f' will tell you differently.
91 That was my original reason to start working with the code.
92
93 Bug fixes: fortune now reads the same file list that it reports with -f.
94 strfile now really sorts and randomizes, instead of just setting the
95 'sorted' and 'randomized' flags.  strfile does not lose the pointer to a
96 fortune that follows a null fortune.
97
98 Enhancements: fortune -f now prints percentages, whether specified on the
99 command line or not.  fortune -m now prints filenames to stderr; the
100 fortunes printed to stdout can be redirected into a file which is valid
101 strfile format.  fortune -l|s can be modified with -n _number_ to specify
102 the number of characters in a short fortune (default 160, as before).
103 The means of distinguishing between offensive and inoffensive fortunes is
104 changed: offensive fortunes are put in a separate subdirectory.  The
105 contents of the fortunes databases have been extensively reviewed, and
106 broken into smaller, more manageable [hopefully] files.
107 strfile is not notably enhanced, though it received the most significant
108 bug fixes.  unstr now accepts a command line parameter -c _char_ which
109 globally changes the delimiter character.  unstr now accepts an output
110 file as the second file parameter, and can tell if a file has a '.dat'
111 extension.
112 An example of the use of fortune-style databases for other purposes,
113 called randstr, has been added.  See util/README.randstr
114 The Makefiles have been extensively hacked upon.
115
116 Bugs: combining -a with xx% filename, when _filename_ is found in both
117 the offensive and the inoffensive directories, causes fortune to exit
118 without an error message.  I think it's confused as to which file gets
119 the xx%.  I should fix this.  Don't hold your breath, though.
120
121 For more information, see the files ChangeLog, Offensive, README.install,
122 and cookie-files in the top-level directory, and the comments in the
123 various *.c source files.
124
125 Amy A. Lewis    alewis@email.unc.edu    October, 1995
126
127 ----Florian's README.LINUX---
128 I have looked at sunsite and tsx and found one very old fortune program
129 and one in the debian Linux distribution. But comparing that one with
130 the version in NetBSD-current showed me, that NetBSD-current has fixed
131 so many speeling-bugs that I just had to repackage everything for the
132 Linux community.
133
134 In the source package are all changes for Linux in the file LINUX.DIF.
135 (Rewriting the Makefiles and some trivial small fixes.)
136
137 I expect this "fortune.tar.gz" to show up under /pub/Linux/games.
138
139 Not only the kernel needs speeling-corrections,
140
141 Florian La Roche      florian@jurix.jura.uni-sb.de      April 1995
142
143
144 PS. The following is the README from the originating NetBSD fortune:
145 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
146
147 #       $NetBSD: README,v 1.2 1995/03/23 08:28:29 cgd Exp $
148 #       @(#)README      8.1 (Berkeley) 5/31/93
149
150 The potentially offensive fortunes are not installed by default on BSD
151 systems.  If you're absolutely, *positively*, without-a-shadow-of-a-doubt
152 sure that your user community wants them installed, whack the Makefile
153 in the subdirectory datfiles, and do "make all install".
154
155 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
156         Some years ago, my neighbor Avery said to me: "There has not been an
157 adequate jokebook published since "Joe_Miller", which came out in 1739 and
158 which, incidentally, was the most miserable no-good ... jokebook in the
159 history of the printed word."
160         In a subsequent conversation, Avery said: "A funny story is a funny
161 story, no matter who is in it - whether it's about Catholics or Protestants,
162 Jews or Gentiles, blacks or whites, browns or yellows.  If a story is genuinely
163 funny it makes no difference how dirty it is.  Shout it from the rooftops.
164 Let the chips fall all over the prairie and let the bonehead wowsers yelp.
165 ... on them."
166         It is a nice thing to have a neighbor of Avery's grain.  He has
167 believed in the aforestated principles all his life.  A great many other
168 people nowadays are casting aside the pietistic attitude that has led them
169 to plug up their ears against the facts of life.  We of The Brotherhood
170 believe as Avery believes; we have never been intimidated by the pharisaical
171 meddlers who have been smelling up the American landscape since the time of
172 the bundling board.  Neither has any one of our members ever been called a
173 racist.  Still, we have been in unremitting revolt against the ignorant
174 propensity which ordains, in effect, that "The Green Pastures" should never
175 have been written; the idiot attitude which compelled Arthur Kober to abandon
176 his delightful Bella Gross, and Octavius Roy Cohen to quit writing about the
177 splendiferous Florian Slappey; the moronic frame of mind which, if carried
178 to its logical end, would have forbidden Ring Lardner from writing in the
179 language of the masses.
180                 -- H. Allen Smith, "Rude Jokes"
181
182         ... let us keep in mind the basic governing philosophy of The
183 Brotherhood, as handsomely summarized in these words: we believe in
184 healthy, hearty laughter -- at the expense of the whole human race, if
185 needs be.
186         Needs be.
187                 -- H. Allen Smith, "Rude Jokes"