home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / QUOTER3.ZIP / QUOTE.DOC < prev    next >
Encoding:
Text File  |  1991-08-06  |  5.7 KB  |  121 lines
  1.                          >>>>> Quoter v 3.00 <<<<<
  2.                           Written By Ryan Brooks
  3.                        Compiled in Turbo Pascal 6.0
  4.  
  5.         Well, This is it.  The long awaited (for me anyway) version 3.00.  This
  6. version is SO much better then the previous 2.  I really owe it all to the use
  7. of Turbo Pascal 6.0.  Previous versions were written using Turbo Pascal 3.3.
  8. Anyway...  I'll get on with the use of the new program.
  9.  
  10.         Required Files in this ZIPfile:
  11. QUOTE3.EXE    --  The Quoter Program.  This is the Great one here.
  12. QUOTE.DOC     --  This file.
  13.         Optional Files in this ZIPfile:
  14. DATENUM.DAT   --  File containing Lastread Quote, and LastDate Quote info.
  15. QUOTES.TXT    --  Text file with the quotes in it.
  16. QUOTE.DAT     --  The QUOTES.TXT file compiled.
  17. QUOTE.BAT     --  A Batch file to run the Quoter with...
  18. QUOTES.NEW    --  Text file with New user quotes in it.
  19.  
  20.         The deal with Optional and Required files:
  21.      Ok...  QUOTE3.EXE is the only really required files to run the program.
  22. It is now capable of creating all the other files that it needs.  Previous
  23. versions had to have 2 other .COM files to aid it in this.  No more.  These
  24. Optional files are included to steer you in the right direction.  You'll
  25. probably want to change these, as soon as you get a hang of the new program.
  26.  
  27.         Need Help with quoter?
  28.      Well, that's Easy!  Just run the program with no command line arguments!
  29. It will give you some short help about the program.
  30.  
  31.         Quoter Commands
  32.      There are 4 commands that the quoter will understand.  These are:
  33.  
  34. C -- Compile
  35. R -- Run
  36. N -- New
  37. A -- Add
  38. E -- Enter
  39.  
  40. That is it.  Here is a description of those commands in detail.
  41.  
  42. C -- Compile.  This command compiles a text file into a Binary file that the
  43.                quoter uses to get it's quotes.  Here is the usage of the
  44.                command:
  45.                         QUOTE3 C <In-file path and name> <Out-file path>
  46.                The In-file path and name is the full path and filename of the
  47.                text file that you wish to compile.  The default is the current
  48.                directory with QUOTES.TXT.  The Out-file path is the path where
  49.                you wish the Binary file to be.  The default is the current
  50.                directory.  NOTE: If you get a run-time error here... you
  51.                                  probably have the wrong path or file name or
  52.                                  something.
  53.  
  54. R -- Run.      This command Runs the Quoter.  Meaning the quoter get's a quote
  55.                and displays it.  The usage of the command is:
  56.                         QUOTE3 R <R, N, or D for run type> <0,1,2 for Port>
  57.                The run type is the method for selecting quotes.  R will result
  58.                in a random selection.  N will read the next quote in the file.
  59.                D is a quote of the day feature.  It will only give one quote a
  60.                day.  The Port is where you want output directed.  1 and 2 for
  61.                their respective COM ports.  0 for local.
  62.  
  63. N -- New.      This resets the DATENUM.DAT file.  It sets the lastread pointer
  64.                to 0, and sets the lastdate to the current date. Usage:
  65.                         QUOTE3 N
  66.  
  67. A -- Add.      This Command allows you to add a quote to the end of the Binary
  68.                file.  The usage of the command is:
  69.                         QUOTE3 A <H or S to Hold or Save> <0,1,2 for Port>
  70.                It will prompt you for the lines and so on.  I included the port
  71.                field, in case any of you want to allow users to add quotes. But
  72.                for those who want to see what the users put in first there is 
  73.                the hold option.  This puts the user's quotes in a file called
  74.                QUOTES.NEW.  You can look at this file before it goes into the 
  75.                list.  The new Quotes are entered using the Enter command.
  76.  
  77. E -- Enter.    This command enters quotes from QUOTES.NEW into QUOTES.TXT and
  78.                in QUOTE.DAT.  Usage:
  79.                         QUOTE3 E
  80.  
  81. That is the detailed look at the commands.  Here are a few examples:
  82.  
  83. QUOTE3 C C:\BBS\LAST.TXT C:\BBS\QT\ << will compile LAST.TXT to c:\BBS\QT\
  84.  
  85. QUOTE3 R R 1 << Will run the quoter with a random quote and output through
  86.                 COM1.
  87.  
  88. QUOTE3 A S 0 << Will Add a Quote locally and Save it.
  89.  
  90.         About the Text file:
  91.      The Text file that you compile is a tricky little bit of work.  It is not
  92. really that hard to understand, and even easier to make.  All it is is a
  93. straight ASCII text file.  There has to be 1 quote to every 3 lines.  Even if
  94. the quote is only 1 line long.  There must be 3 lines.  Here are examples of
  95. 1, 2, and 3 line quotes:
  96.  
  97. This is a ONE line quote.
  98.                                 <<  Blank line holds place!  Must be there!
  99.                                 <<  Blank line holds place!  Must be there!
  100. This is a TWO line quote.
  101. Yep... it sure is.
  102.                                 <<  Blank line holds place!  Must be there!
  103. This is a THREE line quote.
  104. No need for a blank line.
  105. No need at all...
  106.  
  107. There are legal quotes.  They follow the rules.  To end the file, you need to
  108. enter 3 lines of 5 pluses (+++++).  This will signal to the compiler to stop.
  109. See the included QUOTES.TXT to see how it all works.
  110.  
  111. --------------------------------------------------------------------------------
  112.         I'm open to suggestions and PRAISE...  <grin>.  If you like this program
  113. feel free to mail a donation.  If you do... you'll be the first to get any
  114. future versions of this program, or of any others that I can create.
  115.  
  116. Ypres 1914
  117. C/O Frank Ducrest
  118. C/O Episcopal School of Acadiana
  119. P.O. Box 380 -- Highway 92
  120. Cade, LA 70519
  121.