home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / KLS30.ZIP / KLS.DOC < prev    next >
Text File  |  1994-01-23  |  14KB  |  386 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  3.0
  28.           Copyright 1991-1993 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.                                      Page 1
  57.  
  58.  
  59.  
  60.  
  61.  
  62.         
  63.         
  64.         
  65.         
  66.         
  67.         
  68.         KLS 3.0                                                         |
  69.         Copyright 1991-1994 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] [/M] [/V] [/X | /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.                   /H | /?        Display brief help screen.
  107.         
  108.                   /M             Report EGA/VGA memory installed.       |
  109.         
  110.  
  111.                                      Page 2
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                   /N             Return to normal 25-line mode.
  118.                   
  119.                   /V             Verbose report
  120.                    
  121.                   /X             Enter extended video mode (43 lines
  122.                                  for EGA, 50 lines for VGA).
  123.                   
  124.         Examples:
  125.              
  126.              KLS 4                Clears the screen & paints it red.
  127.              
  128.              KLS 6                Clears the screen & paints it brown.
  129.              
  130.              KLS /B4              Turns border magenta.                 
  131.              
  132.              KLS /B1 6            Clears screen & paints it brown with 
  133.                                   a blue border.
  134.              
  135.              KLS /4 /B4 /E        Clears screen, sets screen to 43- or
  136.                                   50-line mode, and paints screen and 
  137.                                   border red.
  138.              
  139.              KLS /N               Clears screen, returning it to 25-
  140.                                   line mode and default color.
  141.              
  142.              KLS /V /M            Clears screen, reports amount of      |
  143.                                   EGA/SVGA memory (if applicable), and  |
  144.                                   reports findings to screen in detail. |
  145.              
  146.         When the screen is cleared, it will be set to the color indi-
  147.         cated on the command line.  Entering KLS without parameters
  148.         is the same as issuing CLS (i.e., clear screen without color).
  149.         "KLS 0" is useful if you have used ANSI or some other method
  150.         to set your screen to a color other than black, but you want
  151.         a black screen temporarily.
  152.         
  153.            The /B switch, by itself, does NOT clear the screen.  Some-
  154.         times you will want to reset the border color without erasing
  155.         what is on the screen (such as when a "misbehaved" program
  156.         changes the color of your screen border and does not reset it).
  157.         
  158.            KLS also detects the type of video display card installed
  159.         and returns errorlevel codes as shown below:
  160.            
  161.              0 - monochrome display adapter (MDA)
  162.              1 - color graphic adapter (CGA)
  163.              2 - extended graphics adapter (EGA)
  164.              3 - video graphics array (VGA)
  165.  
  166.                                      Page 3
  167.  
  168.  
  169.  
  170.  
  171.  
  172.              4 - multi-color graphics adapter (MCGA)
  173.              5 - Hercules graphics adapter
  174.              SVGA cards:
  175.              6 - VESA-compatible SVGA card                              |
  176.              7 - AHEAD-A chipset                                        |
  177.              8 - AHEAD-B chipset                                        |
  178.              9 - ATI 18800 chipset                                      |
  179.             10 - ATI 18800-1 chipset                                    |
  180.             11 - ATI 28800 chipset                                      |
  181.             12 - C&T 82c451 chipset                                     |
  182.             13 - C&T 82c452 chipset                                     |
  183.             14 - C&T 82c453 chipset                                     |
  184.             15 - Genoa 6000 chipset                                     |
  185.             16 - Oak OTI-067 chipset                                    |
  186.             17 - Paradise PVGA1a chipset                                |
  187.             18 - Paradise WD90C00 chipset                               |
  188.             19 - Paradise WD90C11 chipset                               |
  189.             20 - Trident 8800 chipset                                   |
  190.             21 - Trident 8900 chipset                                   |
  191.             22 - Tseng ET3000 chipset                                   |
  192.             23 - Tseng ET4000 chipset                                   |
  193.             24 - Video7 chipset                                         |
  194.             25 - Cirrus Logic 54xx chipset                              |
  195.             26 - S3 chipset                                             |
  196.             27 - Trident 8900B/C chipset                                |
  197.              
  198.            When using the /V switch, a brief screen message describing
  199.         the installed video card is displayed.
  200.         
  201.            When using the /M switch, the errorlevel is set too indicate |
  202.         the type of card and amount of video memory as follows:         |
  203.         
  204.             Errorlevel               Video card & memory                |
  205.             ==========               ===================                |
  206.                 41                       EGA w/64k                      |
  207.                 42                       EGA w/128k                     |
  208.                 43                       EGA w/192k                     |
  209.                 44                       EGA w/256k                     |
  210.                 51                       SVGA w/512k                    |
  211.                 52                       SVGA w/1024k                   |
  212.                 53                       SVGA w/1536k                   |
  213.                 54                       SVGA w/2048k                   |
  214.                 etc...                                                  |
  215.              
  216.            If you make an error (specify an invalid color value), KLS
  217.         will sound a tone return an errorlevel of 255.
  218.          
  219.         OMBUDSMAN
  220.  
  221.                                      Page 4
  222.  
  223.  
  224.  
  225.  
  226.  
  227.         
  228.           This program is produced by a member of the Association of
  229.         Shareware Professionals (ASP).  ASP wants to make sure that
  230.         the shareware principle works for you.  If you are unable to
  231.         resolve a shareware-related problem with an ASP member by
  232.         contacting the member directly, ASP may be able to help.  The
  233.         ASP Ombudsman can help you resolve a dispute or problem with
  234.         an ASP member, but does not provide technical support for 
  235.         members' products.  Please write to the ASP Ombudsman at 545
  236.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  237.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  238.         
  239.         
  240.         DISCLAIMER
  241.         
  242.            The programs described in this documentation are guaran-
  243.         teed to do absolutely nothing!  They have, however, in my exper-
  244.         ience performed essentially as described herein.  The author
  245.         will not be responsible for any loss or damages caused through
  246.         the use of these programs.  No warranty, express or implied,
  247.         is provided for this software's performance, merchantability,
  248.         or fitness for a particular purpose.
  249.         
  250.            All trademarks are property of their respective owners.
  251.         
  252.            The programs and documentation are Copyright 1991,1992 by 
  253.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  254.         grams provided the following conditions are met:
  255.         
  256.            - all files contained in the archive or distribution disk
  257.              must be distributed together in UNMODIFIED form
  258.         
  259.            - you charge no more than a reasonable fee for copying or
  260.              subscription, and clearly indicate that payment of such
  261.              a fee does NOT grant ownership of the programs.
  262.         
  263.            This program is part of set of utilities known as STEEN-
  264.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  265.         utilities includes the following programs:
  266.         
  267.              BATBOX:     Simple menu creation/input system
  268.              CHKDRV:     Checks disk drive status
  269.              CHKPRN:     Checks parallel printer status
  270.              CLK:        Displays time on screen
  271.              CURSOR:     Change cursor shape
  272.              DOSVER:     Checks for DOS version currently running
  273.              INPUT:      Simple prompt/input system
  274.              KLS:        Colorful screen-clearing utility
  275.  
  276.                                      Page 5
  277.  
  278.  
  279.  
  280.  
  281.  
  282.              LAUNCHER:   File selection/execution system
  283.              MUSIC:      Plays transcribed sheet music on the PC
  284.              RAND:       Random number generator
  285.              SKIP:       Prints blank lines from batch files
  286.              SOUNDER:    Wide range of noise making options
  287.              SPACE:      File/disk space reporting utility
  288.              WAITFOR:    Timed pauses 
  289.              WHENISIT:   Date/time telling utility
  290.              WRITE:      Colorful output anywhere on screen
  291.              XD:         Create/switch directories at the same time
  292.         
  293.            You may evaluate these programs for up to 30 days on a free
  294.         trial basis.  After 30 days, you should register your use of
  295.         these programs.  The registration fee is $20, payable to the
  296.         author at the address given below.  For those registering
  297.         directly with Tay-Jee Software, we offer a $5 cash discount.
  298.         
  299.            Let's be real: I don't plan to make a lot of money this way.
  300.         Registration does have its advantages:
  301.         
  302.            - I am improving these programs all the time.  Registration
  303.              will get you IMMEDIATELY a disk with the latest version.
  304.              You will also get the next major release of the program set
  305.              sent to you free of charge.
  306.         
  307.            - While I can't promise to include everyone's suggestions
  308.              in program updates, you can bet I'll listen to registered
  309.              users before any of you scrounges out there.
  310.         
  311.            - You will make me feel all warm and fuzzy and appreciated, 
  312.              and all that good stuff.
  313.         
  314.            - You will also get an evaluation copy of my text file for-
  315.              matting program (used to produce the margins in this doc-
  316.              ument), and any other electronic creations I have decided
  317.              to unleash on a foolish, unsuspecting world.
  318.         
  319.            Send comments/registrations to:
  320.         
  321.                 Tay-Jee Software
  322.                 Post Office Box 835
  323.                 Lexington, VA 24450
  324.                 (703)464-5290
  325.                 
  326.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  327.         
  328.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  329.         
  330.  
  331.                                      Page 6
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.                                      Page 7