**** Amiga Fortunes v 1.0.8, Release 2 ****
          **** Copyright © 2001 Kalle Räisänen ****
 
   0. Contents

0. Contents
1. Installation
2. Usage
3. Problems/Bugs
4. Ports
5. The win2ami program
6. The ami2win program
7. The CountForts program
8. The fsplit program
9. System Requirements


   1. Installation

- Unpack the archive (with "lha e afortunes.lha" for example).
- Copy (or rename) the files in bin to c: (or somewhere else in your path)
- Copy (or rename) the files in fortune-files to s:
- You may want to add afortunes to your user-startup as well,
  add the line "afortunes" to s:user-startup. (To open user-startup with
  ed type "ed s:user-startup" add "afortunes" somewhere near the end, see
  below for a list of options, quit and save with Esc-x, quit without saving
  with Esc-q (nowadays there are also menus, but *real* hackers use keyboard
  shortcuts (then again, real hackers also use EMACS, so... :-))).
- I have also added afortunes to my shell-startup, shell-startup is also in
  the s: directory. I suggest using the -t (or --text) option in shell-startup,
  giving it a real "*nix" feel.


   2. Usage

The syntax is
 
   afortunes [file(s)|options]
or
   afortunes -t|--text [file(s)|options]

where 'file(s)' is any number of optional custom-files, that, if they exist, will be
used instead of the default "SYS:s/fortunes.txt". 
and 'options' is one of:

-h, --help     :  gives short help-text.
-c, --copyright:  shows copyright info.

The -t (or --text) switch makes AFortunes use old-style CLI-output.
The -t (or --text) switch must be first if used.

Example:
   afortunes --text --copyright
Shows copyright info in a CLI-window.

Example 2:
   afortunes -c
Shows copyright info in a requester.

Example 3:
   afortunes -t a-file another-file third-file
Shows a fortunes from either a-file, another-file or third-file in a CLI.

   3. Problems/Bugs

There shouldn´t be too many big bugs; but if you find one, send an email to:
kalle_r@linuxmail.org, describing the problem, your system configuration
and, if you´re using an emulator, which and which version (I hope for your
sake that you´re using UAE, otherwise there´s not much I can do).
   If you think that something is terribly badly done in the source, send
a suggestion for a better way of doing it: kalle_r@linuxmail.org, I can´t
guarrantee that I´ll use it, but if it´s better than my way of doing it I
will.

   4. Ports 

For Linux (and all other UNIX-like systems) there's the exellent 
original Fortunes program, it's much better than this one. It's
included with practically every Linux-distribution.
   For Windows there are many versions, I think mine is one of
the better- mine is also free (GNU GPL). You can get it from my site: 
"http://www.angelfire.com/amiga/grotto/", in the Windows Software
section.
   Other systems: version 0.8.7 should compile cleanly if you 
change the default file to something more suitable than 
"sys:s/fortunes.txt". Later versions will not (without a bit work).
   If your doing a port, you might want to change the function
that counts fourtunes, take a look at the Windows-source- it works
pretty well. For some reason, it won't work right on Amiga. It works,
but it's not 100%. (This is not that big of an issue in 0.8.7, but 
there is room for improvement).


   5. The win2ami program

win2ami is a program which converts dos-files to unix(amiga) format.

Installation:
Copy the win2ami executable to c: (or somewhere else in your path).

The syntax is:

   win2ami file1 file2 [--show|-s]

file1 is the dos-file you want to convert, and file2 is the amiga-file 
you want to create. If you pass the --show (or -s)
argument, win2ami will type the file it´s converting to stdout.


   6. The ami2win program

ami2win is a program which converts unix(amiga)-files to dos format.

Installation:
Copy the ami2win executable to c: (or somewhere else in your path).

The syntax is:

   ami2win file1 file2 [--show|-s]

file1 is the amiga-file you want to convert, and file2 is the dos-file
you want to create. If you pass the --show (or -s)
argument, ami2win will type the file it´s converting to stdout.


   7. The CountForts program

CountForts is a program for counting fortunes in a fortune-file.

Installation:
Copy the countforts executable to c: (or somewhere else in your path).

Syntax:

   countforts [-t|--text] file(s)

The -t (or --text) option works like in AFortunes, makes countforts use CLI-
output.


   8. The fsplit program

fsplit is a program which splits fortune-files into two, without splitting any
fortunes.

Installation:
Copy the fsplit executable to c: (or somewhere else in your path).

Syntax:

   fsplit infile outfile1 outfile2 [outfile3] [outfile4] [...]

Where infile is the file you want to split, and outfile1 - outfileN are the files you
want to create, you must specify at least two outfiles. The infile must also be a
fortune-file, otherwise it will just be copied to outfile1, and the other outfiles will
be empty.
   You should use CountForts on the outfiles.


   9. System Requirements

At least AmigaOS 2.04 (kickstart 37 and above), not much more. It may work on
kickstart 36.x, but I have no way to test it, so I´ve set the limit to what I know for
sure.