home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / rodney / fortune.doc < prev    next >
Encoding:
Text File  |  1989-06-04  |  6.0 KB  |  153 lines
  1. Fortune v1.51 (c)1988 by Kerry K. Flint
  2. Documentation File
  3.  
  4. The main purpose of writting this program was to write a program similiar to
  5. a fortune program like that on unix and PC systems which ran quickly.
  6.  
  7.  
  8. Included in this file are these files:
  9.  
  10.           FORTUNE.TOS    - Program to be run in your .bat file
  11.           FORTUNE.TXT    - Data file containing the "fortunes"
  12.           FORTUNE.DOC    - This documentation
  13.           FORTUNE.DAT    - Data file containing info on fortune.txt
  14.           FORTUNE.PTR    - Data file containing pointers
  15.           FORTUNE.INF    - Data file containing path of output file
  16.           CONVERT.TOS    - Program to convert Quoter 3.0 file to fortune
  17.  
  18. Setting up FORTUNE is easy...
  19.  
  20. 1-  Copy all these files into the main BBS directory on your base drive.
  21.     You may optionally put them into a folder. See below for info on how
  22.     to do this.
  23.  
  24. 2-  edit the  file called FORTUNE.INF.
  25.     On the 1st line of the file you need to specify whether the program
  26.     should overwrite the output file or append to the file.  To do this
  27.     the 1st line should either contain 'append' or 'overwrite' in either
  28.     all lower case or all upper case letters.
  29.     The 2nd line should contain the path to the output file of the fortune.
  30.     The path must be the 2nd line of the file, start at the first column of
  31.     the line and end with a carriage return and line feed.
  32.     Some suggestions as to the file to use include
  33.     DATNOTE.TXT, NOTICE.TXT, LOGOFF.TXT... Anyfile you wish can be used.
  34. An example of the file is
  35. APPEND
  36. C:\BBS\TXT\DATNOTE.TXT
  37.  
  38. Another example
  39. overwrite
  40. c:\forem\text\notice.txt
  41.  
  42.  
  43. 3- Execute the FORTUNE.TOS program for the first time to initialize data
  44.    that may need to be initialized.
  45.  
  46. *NOTE* If you ever need to force a re-initialization because you are getting
  47.        Errors when run, just delete the file fortune.dat.  If this file is
  48.        not found when the program runs, initialization is forced!
  49.  
  50. 4- Add the command in the appropriate batch files.  If you want the fortune
  51.    to be updated after each caller put it in logoff.bat, daily put it in
  52.    fmaint.bat or daily.bat, ect.
  53.  
  54.    If you put all the files to this program in your main bbs directory
  55.    (the same one forem is run from) then the entry in your .bat file
  56.    should be the pathname to the program.  Example :
  57. E:\FOREM\FORTUNE.TOS
  58.  
  59. TO PUT THE FILES INTO A FOLDER
  60. ---------------------------
  61. In version 1.4 the ability for all the files to be placed in any
  62. subdirectory was added.  A command line aproach was taken over a
  63. info file that  would have to be in the forem directory because my
  64. forem folder is getting to full!!!!
  65.  
  66. If no command line is found then the program assumes that the data files
  67. are on the current drive in the current folder.  Which when run from forem
  68. always means the folder that forem.tos is in.
  69.  
  70.  
  71. Anyways, to use the folder option do the following:
  72.  
  73. 1 - Copy all the files to the folder desired.  If you want the FORTUNE.TOS
  74.     file and the data files to be in seperate folders they may be.
  75.     The following files must be in data folder though :
  76.          FORTUNE.TXT
  77.          FORTUNE.INF
  78.     The other files will be initialized into this folder the first time
  79.     Fortune.tos is run if they are not present!
  80.  
  81. 2 - Edit your .bat file  to look like this:
  82.  
  83.     path_prg\fortune.tos path_data\
  84.  
  85.     where path_prg is the complete pathname to FORTUNE.TOS  and
  86.     path_data is the complete pathname to the data files.
  87.     It MUST be  terminated with a back slash!
  88.  
  89.     My BBS EXAMPLE's
  90.     for a new quote every caller I put in logoff.bat file:
  91. E:\FOREM\FORTUNE\FORTUNE.TOS E:\FOREM\FORTUNE\
  92.     for a daily change in the quote I put in daily.bat :
  93. E:\FOREM\FORTUNE\FORTUNE.TOS E:\FOREM\FORTUNE\
  94.  
  95. ADDING FORTUNES
  96. ---------------
  97. If you want to add fortunes to the existing file, all you need to do is
  98. type in the text at the bottom of the file, and terminate it with an
  99. at sign ("@") as the last line of every quote. The "@" must be
  100. the first character of the line.  Any text on that line after the "@" is
  101. ignored!
  102.  
  103. If you don't like the included file, you can generate your own in a like
  104. manner; create a FORTUNE.TXT file and just start typing in fortunes, each
  105. terminated by a line starting with an '@' on it.
  106.  
  107. When FORTUNE.TOS runs and detects a change in the fortune.txt file it will
  108. reread fortune.txt and write a new fortune.dat file and fortune.ptr file.
  109. Thus there is no need for you to tell it to re-initialize anything.
  110.  
  111. USING QUOTER 3.0 FILES
  112. ----------------------
  113. Due to requests by my beta testers, a program was written to convert the
  114. public domain program QUOTER 3.0 quote file to a FORTUNE.TXT file. To due
  115. this put the scene.dat file you used for quoter into the directory you wish
  116. to write fortune.txt to.  Run the program CONVERT.TOS.  If you run convert.tos
  117. from a differant path than the one you want output to go to pass it a parameter
  118. that is the path were output should go.  If no parameter is passed the path
  119. that the program is run from is assumed.
  120.  
  121.  
  122. This program is put into the public domain on 8-3-1988.
  123. distribute these files  in any way you wish provided this document
  124. accompanies the files, and the files are not sold for profit.
  125.  
  126.                                DISCLAIMER:
  127.  
  128.       I make no representations or warranties with respect to the contents
  129.       hereof and specifically disclaim all warranties of merchantability or
  130.       fitness for any particular purpose.   This document is subject to change
  131.       without notice.
  132.  
  133.  
  134.  
  135.       Allthough no fee is required to use this program, if you feel that
  136.       it is a benifit to your BBS and warrents a donation ($5-$10) to the
  137.       author to keep him inspired enough to write more programs send them
  138.       to
  139.  
  140.                 Kerry K. Flint
  141.                 420 Shamrock Dr.
  142.                 Henderson, NV 89015
  143.  
  144. Source code available for a price!
  145.  
  146. I can be reached on the following BBS -
  147.  
  148. The Entertainment Center BBS
  149. FNET Node 285
  150. (702) 796-3214
  151. Kerry  Flint
  152.  
  153.