home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / k / kls20.zip / KLS.DOC < prev    next >
Text File  |  1993-01-10  |  11KB  |  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.                             STEENBURGH'S STUFF
  25.                           Mildly Useful Utilities
  26.                               For Batch Files
  27.                                 Version 2.5
  28.           Copyright 1991,1992 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                             _______
  31.                        ____|__     |               (TM)
  32.                     --|       |    |-------------------
  33.                       |   ____|__  |  Association of
  34.                       |  |       |_|  Shareware
  35.                       |__|   o   |    Professionals
  36.                     -----|   |   |---------------------
  37.                          |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         KLS 2.0                                                         |
  69.         Copyright 1991 by Chuck Steenburgh & Tay-Jee Software
  70.         
  71.            KLS is a simple replacement for the DOS screen-clearing
  72.         function (CLS).  
  73.         
  74.         Usage:       KLS [color] [/Bn] [/E | /N] [/H]                   |
  75.         
  76.                   color           A number from the list below:
  77.         
  78.                                          0 - Black
  79.                                          1 - Blue
  80.                                          2 - Green
  81.                                          3 - Cyan
  82.                                          4 - Red
  83.                                          5 - Magenta
  84.                                          6 - Brown
  85.                                          7 - White
  86.                   
  87.                   /Bn            Change border to color n, where n:
  88.                   
  89.                                          0 - Black
  90.                                          1 - Blue         
  91.                                          2 - Green        
  92.                                          3 - Cyan         
  93.                                          4 - Red          
  94.                                          5 - Magenta      
  95.                                          6 - Brown        
  96.                                          7 - White        
  97.                                          8 - Grey         
  98.                                          9 - Bright blue  
  99.                                         10 - Light green  
  100.                                         11 - Light cyan   
  101.                                         12 - Light red    
  102.                                         13 - Light magenta
  103.                                         14 - Yellow       
  104.                                         15 - Bright white 
  105.                    
  106.                   /E             Enter extended video mode (43 lines    |
  107.                                  for EGA, 50 lines for VGA).            |
  108.                   
  109.                   /N             Return to normal 25-line mode.         |
  110.                   
  111.                   /H             Display brief help screen.             |
  112.                                          
  113.         Examples:
  114.              
  115.              KLS 4                Clears the screen & paints it red.
  116.              
  117.              KLS 6                Clears the screen & paints it brown.
  118.              
  119.              KLS /B4              Turns border magenta.                 |
  120.              
  121.              KLS /B1 6            Clears screen & paints it brown with  |
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                   a blue border.                        |
  130.              
  131.              KLS /4 /B4 /E        Clears screen, sets screen to 43- or  |
  132.                                   50-line mode, and paints screen and   |
  133.                                   border red.                           |
  134.              
  135.              KLS /N               Clears screen, returning it to 25-    |
  136.                                   line mode and default color.          |
  137.              
  138.         When the screen is cleared, it will be set to the color indi-
  139.         cated on the command line.  Entering KLS without parameters
  140.         is the same as issuing CLS (i.e., clear screen without color).
  141.         "KLS 0" is useful if you have used ANSI or some other method
  142.         to set your screen to a color other than black, but you want
  143.         a black screen temporarily.
  144.         
  145.            The /B switch, by itself, does NOT clear the screen.  Some-
  146.         times you will want to reset the border color without erasing
  147.         what is on the screen (such as when a "misbehaved" program
  148.         changes the color of your screen border and does not reset it).
  149.         
  150.            KLS also detects the type of video display card installed
  151.         and returns errorlevel codes as shown below:
  152.            
  153.              0 - monochrome display adapter (MDA)
  154.              1 - color graphic adapter (CGA)
  155.              2 - extended graphics adapter (EGA)
  156.              3 - video graphics array (VGA)
  157.              4 - multi-color graphics adapter (MCGA)
  158.              5 - Hercules graphics adapter
  159.              
  160.            If you make an error (specify an invalid color value), KLS
  161.         will sound a tone return an errorlevel of 255.
  162.         
  163.          
  164.         OMBUDSMAN
  165.         
  166.           This program is produced by a member of the Association of
  167.         Shareware Professionals (ASP).  ASP wants to make sure that
  168.         the shareware principle works for you.  If you are unable to
  169.         resolve a shareware-related problem with an ASP member by
  170.         contacting the member directly, ASP may be able to help.  The
  171.         ASP Ombudsman can help you resolve a dispute or problem with
  172.         an ASP member, but does not provide technical support for 
  173.         members' products.  Please write to the ASP Ombudsman at 545
  174.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  175.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  176.         
  177.         
  178.         DISCLAIMER
  179.         
  180.            The programs described in this documentation are guaran-
  181.         teed to do absolutely nothing!  They have, however, in my exper-
  182.         ience performed essentially as described herein.  The author
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.         will not be responsible for any loss or damages caused through
  191.         the use of these programs.  No warranty, express or implied,
  192.         is provided for this software's performance, merchantability,
  193.         or fitness for a particular purpose.
  194.         
  195.            All trademarks are property of their respective owners.
  196.         
  197.            The programs and documentation are Copyright 1991,1992 by 
  198.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  199.         grams provided the following conditions are met:
  200.         
  201.            - all files contained in the archive or distribution disk
  202.              must be distributed together in UNMODIFIED form
  203.         
  204.            - you charge no more than a reasonable fee for copying or
  205.              subscription, and clearly indicate that payment of such
  206.              a fee does NOT grant ownership of the programs.
  207.         
  208.            This program is part of set of utilities known as STEEN-
  209.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  210.         utilities includes the following programs:
  211.         
  212.              BATBOX:     Simple menu creation/input system
  213.              CHKDRV:     Checks disk drive status
  214.              CHKPRN:     Checks parallel printer status
  215.              CLK:        Displays time on screen
  216.              CURSOR:     Change cursor shape
  217.              DOSVER:     Checks for DOS version currently running
  218.              INPUT:      Simple prompt/input system
  219.              KLS:        Colorful screen-clearing utility
  220.              LAUNCHER:   File selection/execution system
  221.              MUSIC:      Plays transcribed sheet music on the PC
  222.              RAND:       Random number generator
  223.              SKIP:       Prints blank lines from batch files
  224.              SOUNDER:    Wide range of noise making options
  225.              SPACE:      File/disk space reporting utility
  226.              WAITFOR:    Timed pauses 
  227.              WHENISIT:   Date/time telling utility
  228.              WRITE:      Colorful output anywhere on screen
  229.              XD:         Create/switch directories at the same time
  230.         
  231.            You may evaluate these programs for up to 30 days on a free
  232.         trial basis.  After 30 days, you should register your use of
  233.         these programs.  The registration fee is $20, payable to the
  234.         author at the address given below.  For those registering
  235.         directly with Tay-Jee Software, we offer a $5 cash discount.
  236.         
  237.            Let's be real: I don't plan to make a lot of money this way.
  238.         Registration does have its advantages:
  239.         
  240.            - I am improving these programs all the time.  Registration
  241.              will get you IMMEDIATELY a disk with the latest version.
  242.              You will also get the next major release of the program set
  243.              sent to you free of charge.
  244.  
  245.                                      Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.         
  252.            - While I can't promise to include everyone's suggestions
  253.              in program updates, you can bet I'll listen to registered
  254.              users before any of you scrounges out there.
  255.         
  256.            - You will make me feel all warm and fuzzy and appreciated, 
  257.              and all that good stuff.
  258.         
  259.            - You will also get an evaluation copy of my text file for-
  260.              matting program (used to produce the margins in this doc-
  261.              ument), and any other electronic creations I have decided
  262.              to unleash on a foolish, unsuspecting world.
  263.         
  264.            Send comments/registrations to:
  265.         
  266.                 Tay-Jee Software
  267.                 Post Office Box 835
  268.                 Lexington, VA 24450
  269.                 (703)464-5290
  270.                 
  271.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  272.         
  273.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  274.         
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      Page 5