
     CLS (utility)          Free-DOS Alpha 5 release          CLS (utility)



     NAME: 

          CLS - Clears the screen and sets the screen colors 

     SYNOPSIS: 

          CLS [attribute] [color] ["on"] [color] 

     DESCRIPTION: 

          CLS clears all text from the video screen and moves the 
          curso to the upper left hand corner.  Additionally, screen 
          video attributes may be specified to change the color of the 
          text on the screen.  

          CLS will attempt to detect if an ANSI driver is loaded.  If 
          so, CLS will perform an ANSI screen clear.  If no ANSI 
          driver is loaded, CLS will perform a BIOS screen clear.  

          The following attributes are valid, and affect foreground 
          color: 

               Normal, Bright, Underlined,  
               Blinking, Reversed, Invisible 

          The following colors are available: 

               Black, Red, Green, Yellow, Blue, Magenta, White 

     OPTIONS: 

          /A - Force CLS to perform an ANSI screen clear.  

          /B - Force CLS to perform a BIOS screen clear.  

          /R - Reset screen attributes to white characters on a black 
               background.  Useful if display is set to an obnoxious 
               color set.  

          /S - Set screen attributes only, do not clear the screen.  
               Useful for changing the color of text output from a 
          batch file.  

     AUTHOR: 

          Morgan "Hannibal" Toal, based on code from James Hall and 
          Peter Mikalajunas 

     EXAMPLES: 

          To clear the screen to cyan characters on a black 
          background: 

                CLS cyan on black 





                                      -1-

