home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / QOFDV605.ZIP / QOFDAY.DOC < prev    next >
Encoding:
Text File  |  1992-10-26  |  7.3 KB  |  240 lines
  1.                            || Quote O' The Day v6.05 ||
  2.                             `========================'
  3.                                 By Uncle Productions
  4.                            --==========================--
  5.  
  6.                       Supporting PCBoard, Wildcat!, GAP, QBBS,
  7.                        RBBS, Remote Access, Spitfire, WWIV,
  8.                                Telegard, and Renegade.
  9.  
  10.  
  11.  
  12.               Kudos to Ted Freeman, the programming god who writes
  13.                         the best door kit for Quick Basic
  14.  
  15.  
  16.                                   Please take note:
  17.                                   -----------------
  18.  
  19.     This product is provided "as is" without warranty of any kind. The entire
  20.     risk as to the results and  performance of the program is assumed by you.
  21.     Furthermore, the  author does  not warrant, guarantee, or  make any  other
  22.     representations regarding  the use of,  or the  results of the use of the
  23.     program,  and you  rely on the  program and  results  solely at  your own
  24.     risk.  The author  cannot and  will not accept  responsibility for system
  25.     damage, loss of profit, or any other special, consequential or incidental 
  26.     damages  resulting  from  the  use  or  inability  to  use this  product.
  27.  
  28.     
  29.                                       Shareware
  30.                                       ---------
  31.  
  32.     Quote O' The Day is being  distributed as Shareware. Under this concept 
  33.     you may use the SHAREWARE (unregistered) version for a reasonable 
  34.     period of  time for evaluation  after which you must either register 
  35.     your copy or discontinue usage.
  36.  
  37.  
  38.                                     Distribution:
  39.                                     -------------
  40.  
  41.         You have a ßeta copy of Quote O' The Day. DO NOT distribute this
  42. to anyone, unless approved by Tim Miranda.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                     Description:
  73.                                     ============
  74.  
  75. As I wandered my way through BBS's, I thought: Some need to perk up. So, I
  76. thought that giving the user a good quote or phrase would be inspirational
  77. to the user. But the Random Quote Makers out there weren't quite what I was
  78. looking for. I was looking for one that would let the user add phrases and
  79. quotes. So I made one that did.
  80.  
  81. The program comes with to parts: The Quote generator and the user interface.
  82. The quote generator is a regular program, which usually is made into a BBS
  83. event. The user interface is a door that works with most BBS types.
  84.  
  85.  
  86.  
  87.  
  88.                                       THE FILES
  89.                                       ---------
  90.  
  91. Make sure you have all the files in the same directory. In this text I'll 
  92. assume they're in C:\DOORS\QOFDAY, but they don't have to be.
  93.  
  94. QOFDAY.EXE is the door that lets users add and list the quotes.
  95. MKEQUOTE.EXE is the program that actually generates quotes.
  96. QUOTES is the text file with all 3 line quotes and phrases in it.
  97. QOFDAY.CNF is the Config file for QOFDAY.EXE.
  98. MKEQUOTE.CNF is the config file for MKEQUOTE.EXE.
  99. QOFDOOR.BAT is a batch file to run QOFDAY.EXE as a door.
  100. EVENT.BAT is a batch file to run MKEQUOTE.EXE as a BBS event.
  101. ORDER.FRM is the form to print out and send to me ASAP (heh heh).
  102. UNKPROD.INF is a list of support BBS's that Tim Miranda can be reached on.
  103. WHATSNEW. is a text file explaining what's new about this version.
  104. QUOTES.ADD is where quotes added by users are stored for sysop approval.
  105. OKQUOTES.EXE is the program to link QUOTES.ADD and QUOTES (See above)
  106.  
  107. QOFDAY.EXE and MKEQUOTE.EXE generates a log of usage, named QOFDAY.LOG. 
  108. Useful to see who adds what quotes. The log can be deleted at any time.
  109.  
  110.  
  111.                                 ABOUT THE QUOTE FILE:
  112.                                 ---------------------
  113.  
  114.      The Quote file (QUOTES) is formatted a little differently than in previous
  115. versions. All quotes can have unlimited lines, except for sysop restriction. 
  116. This is the format:
  117.  
  118. LINE 1
  119. LINE 2
  120. LINE 3
  121. etc..
  122. +
  123.  
  124.      If you, the SysOp, are adding quotes manually, without the door, make sure you
  125. use all three lines. Suppose you have the quote "Make my day." It would look:
  126.  
  127. "Make my day."
  128. +
  129.  
  130.  
  131.                                 *** IMPORTANT ***
  132.  
  133.         Starting in version 6.02, all quotes that are added by users are
  134. stored in QUOTES.ADD, so sysops can check them for obscenities, and other
  135. bad things. Once the sysop thinks the quotes are ok, (s)he can run OKQUOTES,
  136. which will automatically add them to the actual Quote file (QUOTES.)
  137.  
  138.                                     CONFIG FILE:
  139.                                     ------------
  140.  
  141.                            | User Interface (QOFDAY.EXE)|
  142.  
  143. This config file for the User Interface Door is QOFDAY.CNF. Here it is:
  144.  
  145. <PATH TO BBS INFO + BBS INFO FILE NAME>
  146. <BBS NAME>
  147. <SYSOP FIRST NAME>
  148. <SYSOP LAST NAME>
  149. <MAX NUMBER OF LINES USERS CAN HAVE TO INPUT QUOTES>
  150.  
  151.  
  152.  
  153.         The path to BBS info is where you keep the DORINFOx.DEF, PCBOARD.SYS, 
  154. SFDOORS.DAT, etc. Here's my config file (I use DORINFO1.DEF):
  155.  
  156. C:\BBS\DORINFO1.DEF
  157. Taj Mahal
  158. Tim
  159. Miranda
  160. 5
  161.  
  162.         Pretty simple, huh?
  163.  
  164.  
  165.  
  166.  
  167.                      | Quote Generator (MKEQUOTE.EXE) |
  168.  
  169. The config file for the Quote Generator is MKEQUOTE.CNF. Here it is:
  170.  
  171. <COM PORT #>
  172. <FILE or SEND>
  173.  
  174. COM PORT # is just that: 1, 2, 3, or 4.
  175. The second line is different:
  176. FILE means you want the quote to be sent to a file, specifically THEQUOTE.QOD.
  177. SEND means you want the quote to be sent directly to the user. Use this if you 
  178. want the quote to be generated and sent while the user is ONLINE.
  179.  
  180.  
  181.                                 RUNNING THE PROGRAMS
  182.                                 ********************
  183.  
  184.                           | User Interface (QOFDAY.EXE)|
  185.  
  186. You'll probably want a batch file for this. It might look like:
  187.  
  188. CD\DOORS\QOFDAY
  189. QOFDAY QOFDAY.CNF
  190. CD\BBS
  191. EXIT
  192.  
  193. Just have it change to the QOFDAY directory, then run QOFDAY.EXE with
  194.   the CNF on the command line.
  195.  
  196. (Make sure the BBS makes one of the Door Info files supported)
  197. (In Telegard, just use "DD" in the Menu Editor)
  198.  
  199.  
  200.                                  | Quote Generator |
  201.  
  202. Depending on where you want the quote to be put, there are two things to do:
  203.  
  204. This one is if you want it sent to THEQUOTE.QOD file. You'll want the program
  205.   to make one ANSI Quote and one ASCII Quote. This is easy. Make a batch 
  206.   file looking like this:
  207.  
  208. CD\DOORS\QOFDAY
  209. MKEQUOTE 1
  210. COPY THEQUOTE.QOD C:\BBS\AFILES\LOGON1.ANS
  211. MKEQUOTE 0
  212. COPY THEQUOTE.QOD C:\BBS\AFILES\LOGON1.MSG
  213. CD\BBS
  214. EXIT
  215.  
  216.         Essentially what this does is makes 2 Quote files: One ANSI, One ASCII. 
  217. Then it copies them to the BBS file you want, like in Telegard to the log on 
  218. files. That way both ANSI and ASCII callers can see it.
  219.  
  220.         This is also the way to put the Quote Generator into an event. Just use 
  221. the batch file, EVENT.BAT.
  222.  
  223.         If you want it sent to the user immediately, you must be able to tell 
  224. the program if the user has ANSI of not. In Telegard, you do:
  225.  
  226. MKEQUOTE @G
  227.  
  228.         Where @G is 0 for no ANSI, 1 for ANSI. If you put nothing there, it 
  229. will just display ASCII.
  230.         MkeQuote will make an ANSI THEQUOTE.QOD if there is a 1 in the 
  231. commandline, or ASCII if there is a 0.
  232.  
  233.  
  234.  
  235.  
  236. [For Product Support Please Read UNKPROD.INF for a list of BBS's]
  237.  
  238.  
  239.  
  240.