home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / PFortune3_0.lha / PFortune / PFortune.doc < prev    next >
Encoding:
Text File  |  1994-09-12  |  2.4 KB  |  74 lines
  1.  
  2.                              Peti's Fortune Cookie
  3.                              =====================
  4.  
  5.                    written by Peter Simons <simons@peti.GUN.de>
  6.  
  7.  
  8.     Fortune is in the public domain, meaning you may spread, use and
  9. modify it without any restrictions. Go ahead, do what you want.
  10.  
  11.  
  12.                                  What is it?
  13.                                  -----------
  14.  
  15.     Fortune is a small utility for your entertainment. It's only purpose is
  16. to randomly choose a line out of a text database and to display it on the
  17. screen. Usually, these databases contain funny things like Murphy's Laws
  18. and similar things. Fortune can be used to show you a different gag each
  19. time you boot your machine or it can append a sentence to each Usenet
  20. posting you write, there are no limitations.
  21.  
  22.  
  23.                                 Installation
  24.                                 ------------
  25.  
  26.     All you have to do to install Fortune properly is to copy the
  27. executable somewhere into your command path, usually 'C:'. Additionally,
  28. you should copy the included demo database ('s/fortune.data') to your 'S:'
  29. directory, where Fortune expects it as default.
  30.  
  31.     If you use Fortune very often, you should add the line 'resident
  32. Fortune' to your startup-sequence or user-startup script, what will speed
  33. up the whole process a little bit. (See your system-software manual for
  34. further details on the resident command.)
  35.  
  36.  
  37.                              Commandline Usage
  38.                              -----------------
  39.  
  40.     If the database has been copied to 'S:', Fortune can be started without
  41. any parameters. But if you want Fortune to use another database or just
  42. want to store it in another place, you have to provide the path to the
  43. textfile via commandline.
  44.  
  45. Example: "Fortune UULIB:MyNewFortuneData"
  46.  
  47.  
  48.                                 The database
  49.                                 ------------
  50.  
  51.     You can edit the database using every standard text editor. The format
  52. is the following:
  53.  
  54. # a comment-line
  55. fortune1
  56. fortune2
  57. fortune3
  58.  fortune3
  59.  fortune3
  60. fortune4
  61.  
  62.     The first line of the file is a comment and won't be used by Fortune.
  63. Then every line is taken as one fortune.  If you need several lines for one
  64. fortune, you have to indent the text with a blank beginning with the second
  65. line. The next fortune has to start at the first column again.
  66.  
  67.  
  68.  
  69.                              System requirements
  70.                              -------------------
  71.  
  72. Fortune requires AmigaOS 2.04 or later.
  73.  
  74.