home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / screen / qruler21.arc / QRULER.DOC next >
Encoding:
Text File  |  1989-01-30  |  12.1 KB  |  306 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.     ----------------------------------------------------------------------
  7.     
  8.     ----------  ----------  --      --  --          ----------  ----------
  9.     ----------  ----------  --      --  --          ----------  ----------
  10.     --      --  --      --  --      --  --          --          --      --
  11.     --      --  ----------  --      --  --          --------    ----------
  12.     --  --- --  ----------  --      --  --          --------    ----------
  13.     --   -- --  --    --    --      --  --          --          --    --
  14.     ----------  --     --   ----------  ----------  ----------  --     --
  15.     ----------  --      --  ----------  ----------  ----------  --      --
  16.            --  
  17.     ----------------------------------------------------------------------
  18.     
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                        QRuler - Memory Resident Ruler Bar
  27.                                    v02.01.00
  28.  
  29.     
  30.  
  31.  
  32.  
  33.  
  34.     
  35.     
  36.                                COPYRIGHT (C) 1989
  37.                Shenandoah Valley Software and Jonathan W. Coulter
  38.  
  39.  
  40.                All rights reserved by Shenandoah Valley Software
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                    Another quality ShareWare production from:
  57.                                                              
  58.                            Shenandoah Valley Software
  59.                                  P.O. Box 1456
  60.                              Winchester, Va  22601
  61.  
  62.     QRuler                                                           Page i
  63.     -----------------------------------------------------------------------
  64.                       T A B L E    O F    C O N T E N T S
  65.     -----------------------------------------------------------------------
  66.     
  67.     
  68.     
  69.         Introduction ...............................................  1
  70.         
  71.         Files Included in this Version .............................  2
  72.     
  73.         Using QRuler ...............................................  3
  74.     
  75.         Disabling QRuler ...........................................  3
  76.     
  77.         Availabilty of Source Code .................................  4
  78.     
  79.         History of Revisions .......................................  5
  80.     
  81.         Registration ...............................................  6 
  82.     
  83.         Software License Agreement and Limited Warranty ............  7
  84.     
  85.         Copyrights and Trademarks ..................................  8
  86.  
  87.     QRuler                                                           Page 1
  88.     -----------------------------------------------------------------------
  89.                             I N T R O D U C T I O N
  90.     -----------------------------------------------------------------------
  91.     
  92.     
  93.     
  94.     The initial  writing  of QRuler was to learn how to write  a functional
  95.     memory  resident  program.  In the process of development,   an  actual 
  96.     application  begun to develop.  Quite often in programming,  and  other 
  97.     areas,   there is a need to know the exact screen coordinates.   QRuler 
  98.     then developed into what you have in your hands today. 
  99.  
  100.     QRuler v02.01.00 was developed using Turbo Pascal v5.0  with the aid of 
  101.     Turbo Professional by Turbo Power Software.  It was compiled on a Tandy 
  102.     1200HD and tested successfully on the Tandy 1000,  Tandy 3000,  and the 
  103.     IBM PC, XT and AT. 
  104.  
  105.     QRuler                                                           Page 2
  106.     -----------------------------------------------------------------------
  107.         F I L E S    I N C L U D E D    I N    T H I S    V E R S I O N
  108.     -----------------------------------------------------------------------
  109.     
  110.     
  111.     
  112.         QRULER.EXE  - executable program
  113.     
  114.         QRULER.DOC  - documentation
  115.     
  116.         QRULER.REG  - registration form and information 
  117.     
  118.         SUPPORT.DOC - file outlining how to get support from SVS
  119.  
  120.     QRuler                                                           Page 3
  121.     -----------------------------------------------------------------------
  122.                             U S I N G    Q R u l e r
  123.     -----------------------------------------------------------------------
  124.     
  125.     
  126.     
  127.     To  load QRuler,  simply type QRULER at your dos prompt.  It will  then 
  128.     place itself in memory automatically.  To activate,  press the Hot Key. 
  129.     The  Hot Key of the ShareWare version is Ctrl-Tab.  When activated,   a 
  130.     ruler  bar will appear on the 10th line of the screen.  On the line  is 
  131.     your  "cursor  block".  In addition,  the current X,Y position  of  the 
  132.     cursor block will also appear on the bar. 
  133.  
  134.     While  using  QRuler,  several keys have special functions.  These  are 
  135.     outlined below: 
  136.  
  137.       Right Arrow         - move cursor block to the right
  138.       Left Arrow          - move cursor block to the left
  139.       Up Arrow            - move ruler bar up one line
  140.       Down Arrow          - move ruler bar down one line
  141.       PgUp                - move ruler bar to the top of the screen
  142.       PgDn                - move ruler bar to the bottom of the screen
  143.       Home                - move cursor block to the beginning of the line
  144.       End                 - move cursor block to the end of the line
  145.       Esc                 - exit QRuler & returns control to your program
  146.  
  147.     QRuler only works in 80 x 25 video modes. A future enhancement would be 
  148.     to  add  support  for other video modes.  If you desire  this  feature, 
  149.     please let us know about it.
  150.     
  151.     Programmer's  Note:  The screen as far as QRuler is concerned begins at 
  152.     position 1,1 (X,Y) and ends at 80,25 (X,Y). Some languages, like dBase, 
  153.     begin at 0,0.  It should also be noted that X,Y in this case relate  to 
  154.     Column,Row.  Some languages, and/or utilities,  reference the screen by 
  155.     Row,Column.   If this is the case,  simply reverse what you see on  the 
  156.     screen. 
  157.     
  158.     
  159.                                 DISABLING QRuler
  160.     
  161.     To disable QRuler, simply press Shift-Tab while the ruler bar is on the 
  162.     screen. Then press Esc and QRuler will "unload" from memory. 
  163.  
  164.     QRuler                                                           Page 4
  165.     -----------------------------------------------------------------------
  166.             A V A I L A B I L I T Y    O F    S O U R C E    C O D E
  167.     -----------------------------------------------------------------------
  168.     
  169.     
  170.     
  171.     The Turbo Pascal source code is available only to registered users.  If 
  172.     you request a copy of the source code,  it will be sent free with  your 
  173.     registered  version.  If you have already registered,  there is a $3.00 
  174.     shipping  &  handling  charge  and  you  must  provide  us  with   your 
  175.     registration number. 
  176.     
  177.     The  source  code  IS NOT ShareWare and may not be distributed  in  any 
  178.     fashion, PERIOD.  You may not distribute recompiled versions of QRuler. 
  179.     If you wish to see your personal enhancement included,  please send  it 
  180.     to us and we will see that you receive proper credit. 
  181.  
  182.     Lastly, in order to recompile QRuler,  you must use Turbo  Professional 
  183.     published  by  Turbo Power Software.  It makes use of the  TPTSR  unit. 
  184.     QRuler may be compiled under both Turbo Pascal v4.x and v5.x. 
  185.  
  186.     QRuler                                                           Page 5
  187.     -----------------------------------------------------------------------
  188.                    H I S T O R Y    O F    R E V I S I O N S
  189.     -----------------------------------------------------------------------
  190.     
  191.  
  192.  
  193.     10-21-88 (v01.00.00)
  194.  
  195.        First release of QRuler. File size of 20K. Did not support color. 
  196.        X,Y position displayed in box in upper left corner of screen. Could
  197.        not move ruler bar into that box. Included source in distribution
  198.        file.
  199.  
  200.  
  201.     01-10-89 (v2.00.00)
  202.  
  203.        Beta Test version. Not released to public. Added color support. 
  204.        Rewrote most of code to reduce size. File size reduced to 16K
  205.  
  206.  
  207.     01-29-89 (v2.01.00)
  208.  
  209.        Second public release. Moved X,Y position display to ruler bar to
  210.        allow full access to screen. Further reduced code size to little 
  211.        over 13K. Removed source code from distribute file.
  212.  
  213.     QRuler                                                           Page 6
  214.     -----------------------------------------------------------------------
  215.                             R E G I S T R A T I O N
  216.     -----------------------------------------------------------------------
  217.     
  218.  
  219.  
  220.     As  a  registered  owner  of QRuler  you  will  receive  the  following 
  221.     benefits: 
  222.  
  223.       o  A customized version of QRuler (non-ShareWare)
  224.  
  225.       o  One free update
  226.  
  227.       o  Notification of future updates with option to receive for a small
  228.          shipping & handling fee
  229.  
  230.       o  Notification of future products from Shenandoah Valley Software
  231.  
  232.     
  233.     Registration of  QRuler is only $10.00 and will assure  that  SVS  will 
  234.     continue to develop and release quality ShareWare for all to enjoy.  To 
  235.     register your copy, print and fill out the QRULER.REG file.
  236.     
  237.     When you register QRuler, let us know what you would like to use as the 
  238.     Hot  Key,   and the colors you would like to use.  This  will  be  your 
  239.     personal customized version of QRuler. It will not be ShareWare. 
  240.  
  241.     QRuler                                                           Page 7
  242.     -----------------------------------------------------------------------
  243.                 SOFTWARE LICENSE AGREEMENT AND LIMITED WARRANTY
  244.     -----------------------------------------------------------------------
  245.     
  246.  
  247.  
  248.     IMPORTANT
  249.  
  250.     The  files  contained  in  this  distribution  file  are  licensed   by 
  251.     Shenandoah Valley Software, hereafter refered to as SVS, to the user as 
  252.     set forth below. 
  253.  
  254.  
  255.     COPYRIGHT
  256.  
  257.     This  software  is copyrighted under United States  Copyright  Law  and 
  258.     International Treaty Provisions. 
  259.  
  260.     You are authorized to distribute the QRuler archive in any fashion  the 
  261.     user  wishes so long as each and every one of the below conditions  are 
  262.     met. 
  263.  
  264.     1. This version of QRuler must be distributed in .ARC format  under the 
  265.        name of QRULER21.ARC.
  266.  
  267.     2. The archive file must contain all of the files as listed on page two
  268.        of this document without any modification of any kind.
  269.  
  270.     3. You may not sell this package to  anyone.  If  you  distribute  this 
  271.        package, any fees collected must  be specified  as material/handling 
  272.        and may not exceed $7 in any case.
  273.  
  274.     4. If QRuler is to be distributed in  conjunction with another product, 
  275.        you must  first  obtain written permission (which is usually readily 
  276.        given) from SVS.
  277.  
  278.     In  no event will SVS be liable to you for any damages,  including  any 
  279.     lost  profits,   lost  savings or other  incindental  or  consequential 
  280.     damages  arising out of the use or inability to use this product,  even 
  281.     if SVS has been advised of the possibility of such damages,  or for any 
  282.     claim  made  by  any other party.  This software is  provided  "as  is" 
  283.     without warranty of any kind,  either expressed or implied,  including, 
  284.     but  not  limited  to the implied  warranties  of  merchantability  and 
  285.     fitness for a particular purpose. The entire risk as to the quality and 
  286.     performace of the program rests with the user. 
  287.  
  288.     QRuler                                                           Page 8
  289.     -----------------------------------------------------------------------
  290.                 C O P Y R I G H T S    &    T R A D E M A R K S
  291.     -----------------------------------------------------------------------
  292.     
  293.  
  294.  
  295.     Turbo Pascal is a registered trademark of Borland International.
  296.  
  297.     Turbo Professional is a registered trademark of TurboPower Software.
  298.     
  299.     TurboPower Software is a trademark of TurboPower Software.
  300.  
  301.     IBM PC, XT, AT are registered trademarks of Internation Business 
  302.       Machines Corporation.
  303.  
  304.     Other trademarks of other companies mentioned in this document appear 
  305.     for identification purposes only.
  306.