home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / TEXT / UTILITY / QT201.ZIP / QUOTE.DOC < prev    next >
Encoding:
Text File  |  1991-07-04  |  20.1 KB  |  733 lines
  1.  
  2.  
  3.  
  4.  
  5.                                  QQQQQQQQQQQQQQQQQQQQ
  6.                              QQQQQQQQQQQQQQQQQQQQQQQQQQQQqq
  7.                            QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQqq
  8.                           QQQQQQQQQQQqqqqqqqqqqqqQQQQQQQQQQQqq
  9.                           QQQQQQQQQqq              QQQQQQQQQqq
  10.                          QQQQQQQQQqq                QQQQQQQQQqq
  11.                          QQQQQQQQQqq                QQQQQQQQQqq
  12.                         QQQQQQQQQqq                  QQQQQQQQQqq
  13.                         QQQQQQQQQqq                  QQQQQQQQQqq
  14.                         QQQQQQQQQqq                  QQQQQQQQQqq
  15.                         QQQQQQQQQqq                  QQQQQQQQQqq
  16.                         QQQQQQQQQqq                QQ QQQQQQQQqq
  17.                          QQQQQQQQQqq              QQQQ QQQQQQqq
  18.                          QQQQQQQQQqq             QQQQQQ QQQQQqq
  19.                           QQQQQQQQQq            QQQQQQQQ QQQqq
  20.                           QQQQQQQQQQQ          QQQQQQQQQQ QQqq
  21.                            QQQQQQQQQQQQQQQQQQ QQQQQQQQQQQQqq
  22.                              QQQQQQQQQQQQQQQQQ QQQQQQQQQQQQqq
  23.                                qqQQQQQQQQQQQQQQ QQQQQQQQQQQQqq
  24.                                    qqqqqqqqqqqqq QQQQQQQQQQQQqq
  25.                                                   QQQQQQQQQQQQqq
  26.                                                     qqqqqqqqqqqq
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                              For IBM-PC Compatibles
  35.  
  36.  
  37.                                    DOS Version
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.         QT_QUOTE                                             Version 2.01
  54.         -----------------------------------------------------------------
  55.         (C) 1991 CT Software Systems                  All rights reserved
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                         1
  62.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                     CONTENTS
  69.  
  70.  
  71.  
  72.  
  73.              Copyright Notice..................................3
  74.  
  75.              License...........................................3
  76.  
  77.              Disclaimer........................................3
  78.  
  79.              Registration......................................4
  80.  
  81.              Installation......................................5
  82.  
  83.              Using QT-QUOTE....................................6
  84.                   /h Help......................................6
  85.                   /q Quote file................................6
  86.                   /x Silent....................................6
  87.                   /i Index.....................................7
  88.                   /S Statistics................................7
  89.                   /s Subject selection.........................7
  90.                   /d Delay.....................................7
  91.                   /c Carousel mode.............................7
  92.                   /f File mode.................................8
  93.                   /p Printer mode..............................8
  94.                   Quote selections.............................8
  95.  
  96.              Use with Bulletin Board software..................9
  97.  
  98.              Known problems...................................10
  99.  
  100.              Enhancements next version........................11
  101.  
  102.              Credits..........................................12
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                         2
  123.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  124.  
  125.  
  126.  
  127.                                 COPYRIGHT NOTICE
  128.  
  129.         The QT-QUOTE code and documentation is the copyright of CTS, and
  130.         may not be copied, transmitted, or reproduced, in part or in
  131.         whole, except within the terms of the following licence, without
  132.         the permission of the author.
  133.  
  134.  
  135.                                      LICENSE
  136.  
  137.         Non-commercial users are granted a limited licence to use QT-
  138.         QUOTE without any registration fee (registration is optional) or
  139.         payment being made to the author, though voluntary contributions
  140.         would be gratefully accepted.
  141.  
  142.         Bulletin Board system operators who levy a charge for the use of
  143.         their boards, apart from those that charge only for the use of
  144.         special features such as second-lines, etc, must register their
  145.         copies of QT-QUOTE with the author and pay the registration fee
  146.         of 10 Pounds sterling.
  147.  
  148.         All users are granted a limited licence, and are encouraged, to
  149.         copy and distribute QT-QUOTE provided the following conditions
  150.         are met:
  151.  
  152.              1.   QT-QUOTE must be distributed in absolute unmodified-
  153.                   form, including all the associated files.
  154.  
  155.              2.   QT-QUOTE may not be distributed with or as part of
  156.                   another product without prior consent from the author.
  157.  
  158.              3.   No charge may be levied for copying or distribution of
  159.                   QT-QUOTE, other than the material costs of the storage
  160.                   media, this should be limited to 5 pounds sterling (or
  161.                   equivalent in other currency).
  162.  
  163.  
  164.                                    DISCLAIMER
  165.  
  166.         IN NO EVENT SHALL ADRIAN COLLINS OR DAVID TONGE BE LIABLE FOR
  167.         DAMAGES (OR LOSS OF DATA, PROFITS OR SANITY) ARISING FROM THE USE
  168.         OR MISUSE OF QT-QUOTE VERSION 2.01
  169.  
  170.         QT-QUOTE is user supported, it is shaped by feedback that we get
  171.         from you.  So, help us support QT-QUOTE by sending us any quotes,
  172.         jokes, famous anniversaries, or information on any problems you
  173.         are  having  with  the program, and indeed  any  suggestions  for
  174.         improvements.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                         3
  184.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  185.  
  186.  
  187.  
  188.                                   REGISTRATION
  189.  
  190.         Registration of QT-QUOTE is not essential but it helps us to
  191.         support our software.  The suggested registration fee is 2
  192.         postcards.  Please send them to the addresses below.  But what's
  193.         in it for you?
  194.  
  195.              1.   Information on updates to QT-QUOTE and its associated
  196.                   files, and new releases.
  197.  
  198.              2.   If you run a bulletin board you will get your name and
  199.                   number in the special advertising supplement,
  200.                   GOODGUY.LST.
  201.  
  202.         Even if you don't wish to register your copy of QT-QUOTE, please
  203.         write to us telling us who you are, where you live and where you
  204.         got your copy of QT-QUOTE from.  We like to know (just out of sheer
  205.         curiosity) where our software has managed to spread to, and how
  206.         effectively the software filters through to different places.
  207.         Just because you haven't registered doesn't mean we don't want to
  208.         hear from you.
  209.  
  210.         Send the postcards (preferably picture postcards) to the follow-
  211.         ing addresses.  Similarly all comments, suggestions, and contri-
  212.         butions (even quotes) would be greatly appreciated, and should be
  213.         sent to:
  214.  
  215.         Adrian Collins                     David Tonge
  216.         70 Broad Oak Lane,                 47 Saddlewood Avenue,
  217.         Didsbury,                          East Didsbury,
  218.         Manchester, M20 0GG                Manchester, M19 1QW
  219.         ENGLAND                            ENGLAND
  220.  
  221.         Telephone:                         Telephone:
  222.         +44 061 434 3484                   +44 061 432 3251
  223.  
  224.         Email (JANET):                     Email (FIDONET):
  225.         collinsa@uk.ac.man.cs.p4           2:250/107
  226.         a.m.collins@uk.ac.mcc
  227.  
  228.         Email (OTHER):
  229.         collinsa@p4.cs.man.ac.uk
  230.         a.m.collins@mcc.ac.uk
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                         4
  245.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  246.  
  247.  
  248.  
  249.                                   INSTALLATION
  250.  
  251.         You won't need to create a suitably named directory.  We have
  252.         made it sit in the directory \QUOTE automatically when you
  253.         unarchive it.  This has several advantages:
  254.  
  255.              1.   It suggests what the directory holds.
  256.  
  257.              2.   It's not copyright.
  258.  
  259.              3.   Many others that we haven't though of yet.
  260.  
  261.         The archive is self extracting.  To cause it to discharge itself
  262.         all over your hard disc, type QT-QUOTE.  You will now find a
  263.         directory C:\QUOTE full of the quote code and files.
  264.  
  265.         You should find in the recently-created directory the following
  266.         files:
  267.  
  268.         00HISTOR       The history of the quote program.
  269.         BBSQUOTE.BAT   Creates QUOTE.ANS and QUOTE.ASC for BB use.
  270.         GOODGUY.LST    The list of good guys who registered.
  271.         QINTRO.ASC     \
  272.         QINTRO.ANS      \ The files that sit around the quote when
  273.         QOUTRO.ASC      / created for BB use.  ASC is ASCII, ANS is ANSI!
  274.         QOUTRO.ANS     /
  275.         QUOTE.DOC      You need to ask?  You're reading it.
  276.         QUOTE.EXE      Run this for a nice quote.
  277.         QUOTES.TXT     The file full of quotes.
  278.  
  279.         You should now run QUOTE. The slight delay (as described by the
  280.         unarching program) will be due to QT-QUOTE creating the index.
  281.         It shouldn't be more than 5 minutes on the slowest of machines
  282.         (as Mark Burton can vouch for after trying it on a 4.77MHz PC).
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.                                         5
  306.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  307.  
  308.  
  309.  
  310.                                  USING QT-QUOTE
  311.  
  312.         Most of what you need to do to run quote is completely obvious.
  313.         The simplest way is just to type:
  314.  
  315.              QUOTE
  316.  
  317.         This will pop up a window onto the screen containing the
  318.         quotation, and who said it.
  319.  
  320.         Of course, there's always some pedant who wants to try and do
  321.         something clever with his favourite program (QT-QUOTE).  So
  322.         especially for Dave Gorski, here are the switches:
  323.  
  324.  
  325.  
  326.         /h  HELP
  327.  
  328.         The most important option.  Allows you to see the available
  329.         command line options when you've thrown the documents away.
  330.  
  331.  
  332.  
  333.         /q  QUOTE FILE
  334.  
  335.         Allows you to specify the path for the quote file.  It will
  336.         otherwise try to use the file QUOTE.TXT in the current directory
  337.         if one exists.  If it doesn't find it there, it tries for
  338.         QUOTES.TXT in the directory containing the QT-QUOTE program.
  339.  
  340.              eg. /q c:\quotes\quotes.txt
  341.  
  342.         This is useful for having your quotes in a separate directory
  343.         from where you run it.  Why you'd want to do this, we don't
  344.         know...  You might of course, have several separate quote files.
  345.  
  346.         The quotes file may be given any name but the index file will
  347.         always have the extension .IDX.  This means you can not have
  348.         multiple quote files names, for example, QUOTE.1, QUOTE.2 and
  349.         QUOTE.3 as the index file would be QUOTE.IDX for all of them.
  350.  
  351.  
  352.  
  353.         /x  SILENT MODE
  354.  
  355.         Inhibits the credits window (boo hoo) and some of the less impor-
  356.         tant warning messages.  The title message can be removed while it
  357.         is being displayed by pressing a key.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.                                         6
  367.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  368.  
  369.  
  370.  
  371.         /i  INDEX
  372.  
  373.         This switch forces the quote file to be indexed.  Usually QT-
  374.         QUOTE will automatically index the data files if they are newer
  375.         than their associated indexes.  It does this by checking file
  376.         times.
  377.  
  378.  
  379.  
  380.         /S  STATISTICS
  381.  
  382.         Displays statistics on the current quote and index files, along
  383.         with a list of subjects and the number of quotes in each (smart
  384.         eh?).  Note the subtle difference in case between this and the
  385.         next option.
  386.  
  387.  
  388.  
  389.         /s  SUBJECT
  390.  
  391.         Allows the quotes to be restricted to only those of a certain
  392.         subject.  Bear in mind that the quote numbers will relate to the
  393.         number of the quote in the selected subject, as opposed to the
  394.         number of the quote in the quote file.
  395.  
  396.              eg. /s oneliners
  397.  
  398.         This example will cause QT-QUOTE to select only the oneliners
  399.         quotes.
  400.  
  401.  
  402.  
  403.         /d  DELAY
  404.  
  405.         Specifies the number of seconds that the quote will be displayed
  406.         (either in normal windowed mode or carousel mode)
  407.  
  408.              eg.  /d 10
  409.  
  410.         This example will cause a 10 second delay before bringin up the
  411.         next quote.
  412.  
  413.  
  414.  
  415.         /c  CAROUSEL MODE
  416.  
  417.         Selects carousel mode.  In this mode, random quotes are displayed
  418.         from at 10 second intervals (by default).  It is possible to move
  419.         onto the next quote at any time by pressing any key.  To quit
  420.         carousel mode press ESC.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                                         7
  428.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  429.  
  430.  
  431.  
  432.         /f  FILE MODE
  433.  
  434.         Forces quotes to be sent to STDOUT instead of being displayed in
  435.         a text window.  Quote also automatically sends quotes to STDOUT
  436.         if the program output is redirected on the command-line.
  437.  
  438.              eg. quote /f
  439.                  quote > test
  440.  
  441.         The second will send the output to the standard output stream.
  442.         In the second case, this is redirected to the test file.  Note
  443.         that QT-QUOTE knows you are redirecting and does not bother with
  444.         output in a window.
  445.  
  446.  
  447.  
  448.         /p  PRINTER
  449.  
  450.         This is like the above /f option, except the output is formatted
  451.         for an Epson compatible printer.  If the output is not redirected
  452.         on the command line then quotes are sent to PRN:, otherwise they
  453.         are sent to the standard output stream. The /p option may also be
  454.         followed by a number specifying the page length in lines.
  455.  
  456.              eg. QUOTE /p >LPT2
  457.  
  458.         Which would print on the second parallel printer.
  459.  
  460.              eg. QUOTE /p 675 >COM1
  461.  
  462.         Would print on COM1 using 675-line pages...
  463.  
  464.         Please note that this will seriously damage your stock of blank
  465.         paper.  You tend only to get an average of 10 quotes on a page
  466.         and that's around 500 sheets of paper.  For your own sake, don't
  467.         have your printer in manual feed mode...
  468.  
  469.  
  470.  
  471.         QUOTE SELECTION
  472.  
  473.         If you particularly like one such quote, or a particular range
  474.         (I'd recommend 307-321), you should use this option.  Note that
  475.         the spaces around the ' - ' character are essential.
  476.  
  477.              eg. QUOTE 1 - 10         Displays the quotes 1 to 10
  478.                  QUOTE 50 to 100      Displays the quotes 50 to 100
  479.                  QUOTE 4000 -         Displays the quotes from 4000
  480.                  QUOTE 1 4 6 - 10     Displays quotes 1, 4, and 6 to 10
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                         8
  489.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  490.  
  491.  
  492.  
  493.                             USE WITH BULLETIN BOARDS
  494.  
  495.         Although we used to have some experience of running previous
  496.         versions of QT-QUOTE on bulletin boards a few years back, we
  497.         can't really claim that any more.  So this might not work for all
  498.         bulletin board software, although it worked with a QBBS running
  499.         Binkley...
  500.  
  501.         Quite simply, have your BinkleyTerm batch file run BBSQUOTE.BAT
  502.         after each user logs out of the bulletin board.  If you're not
  503.         running a mailer then CALL BBSQUOTE.BAT should be added to your
  504.         BBS autoexec file before the BBS software is executed.  The
  505.         BBSQUOTE batch file will generate the WELCOME.ANS and WELCOME.ASC
  506.         files as seen in the previous version, QQTF 1.04, before each
  507.         user.
  508.  
  509.         You will probably need to modify the BBSQUOTE.BAT file to copy
  510.         the WELCOME.A?? files into your miscellaneous text files
  511.         directory where the BBS software can find them.
  512.  
  513.         If you normally have your welcome file doing something then
  514.         append your existing files to QOUTRO.ASC and QOUTRO.ANS.  These
  515.         two files are displayed directly after the quote.  Should you
  516.         want something before the quote as well, then have this in the
  517.         QINTRO.A?? files.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                                         9
  550.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  551.  
  552.  
  553.  
  554.                                  KNOWN PROBLEMS
  555.  
  556.         Hopefully this section should be rather short, but if you've got
  557.         anything to add please drop us a line on the addresses given at
  558.         the beginning of this documentation.
  559.  
  560.  
  561.         * CGA Flicker
  562.  
  563.         This one was notice by Mark Burton while recently messing around
  564.         with an ancient 4.77Mhz PC.  Luckily this only affects very old
  565.         CGA cards, and happens because QT-QUOTE accesses video RAM di-
  566.         rectly for speed.
  567.  
  568.  
  569.         * TABS
  570.  
  571.         Tabs aren't handled at all by QT-QUOTE.  They get displayed as a
  572.         circle and, hence, unless you intend to have lots of circles in
  573.         your quotes use spaces for now.  This will however be sorted out
  574.         in the next version.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.                                         10
  611.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  612.  
  613.  
  614.                             ENHANCEMENTS NEXT VERSION
  615.  
  616.  
  617.         * Events
  618.  
  619.         These are things that happened on this day in history. It could
  620.         also be used to remind you of peoples birthdays as well if you so
  621.         wish.
  622.  
  623.  
  624.  
  625.         * Quote file Compression
  626.  
  627.         Because the Quote file is getting so large and unweildy, we think
  628.         this is quite necessary.  We're currently experimenting with
  629.         different compression routines.
  630.  
  631.  
  632.  
  633.         * Better BB support
  634.  
  635.         Maybe we'll have full Bulletin-Board support integrated into the
  636.         program this time...  It all depends on whether SysOps can help
  637.         us by telling us the best way to install quote.  Answers on a
  638.         postcard please.  Automatic installation may even be on the
  639.         cards.
  640.  
  641.  
  642.  
  643.         * Microsoft Windows version soon!
  644.  
  645.         We've had quite a few requests for a windows version.  Not much
  646.         use for BBS support but quite nice if you want to pop up a quote
  647.         while looking for inspiration.
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.                                         11
  672.         QT_QUOTE v2.01                             Copyright (C) CTS 1991
  673.  
  674.  
  675.  
  676.                                      CREDITS
  677.  
  678.  
  679.         * Adrian Collins
  680.  
  681.         Who got landed with the job of writing the program in the end.
  682.         He also insisted on having his name on the documentation, after
  683.         all he did co-write this documentation.
  684.  
  685.  
  686.  
  687.         * David Tonge
  688.  
  689.         Who's fault it is that I ever got onto writing quote programs.
  690.         He was the author of QQTF 1.04 and a major contributer to the
  691.         quote file.  Among other things he was the main Beta-tester and
  692.         wrote most of this documentation.  Also wrote the Archimedes
  693.         version, ARQUOTE.
  694.  
  695.  
  696.  
  697.         * Gerald Iles
  698.  
  699.         For various ideas and comments, especially for sitting there and
  700.         listening to me natter on when bug hunting.
  701.  
  702.  
  703.  
  704.         * Nick Waltham
  705.  
  706.         Thanks for helping to test the program.  If anybody can
  707.         find/create a bug, he could...
  708.  
  709.  
  710.  
  711.         * Kate Russell
  712.  
  713.         For the one quote she contributed.  Every little helps!!!  If you
  714.         have any more, please tell me.
  715.  
  716.  
  717.  
  718.         * James Lovell
  719.  
  720.         For putting up with me grumbling when things were going not as
  721.         expected, and for nagging me to put the subjects into this ver-
  722.         sion.  We all know which quotes you want to see James...
  723.  
  724.  
  725.  
  726.         * Mark Burton
  727.  
  728.         For his personal, sometimes cutting, quotes.  Remember "You've
  729.         got to be cruel to be cruel".
  730.  
  731.  
  732.                                         12
  733.