 


    NAME
              LS_COLOR -- produces a color-coded directory listing

    SYNOPSIS
              ls [-1CFadfglmnopqrstxz?] [file...]

    DESCRIPTION

              LS_COLOR is a general purpose directory listing program that
         is similar but not identical to the UNIX "ls" program.  The most
         common use of LS_COLOR is to find out what files are in the
         current directory.  No command line argument is required for this,
         simply type ls [Enter].  To get detailed information about the
         listed files, to specify the scope of the files to be listed or to
         modify the form of the output, the options listed below are
         provided.  Many options can be used in combination with others.
         Options are case sensitive (-C and -c are not the same).

    HELP

         A short summary of the options can be displayed by typing:

                  ls -? [Enter]

    OPTIONS

    
       Option                           Meaning
    

         -1       List names in one column.  No statistics are displayed.

         -C       List names in multiple columns, sorted down the columns
                  (the sequence is read like a magazine page with two
                   columns).  This is the default if no option is specified

         -F       List directory names with a trailing slash (/) and all
                  executable files with an asterisk (*).

         -a       List all files and directories including those marked
                  hidden and system.  The default is to not list hidden and
                  system entries.

         -d       List only directories.  Files are excluded.

         -f       List files only.  Directories are excluded.  This option
                  may be combined with option -a.

         -g       Get the number of unused bytes on the specified drive.
                  If no drive is specified, the current drive is assumed.

         -l       List in "long" form.  The listing includes the settings
                  of the attribute bits for each entry, the date/time stamp
                  and the size of the entry in bytes.

         -m       List in "mashed" form.  A list of comma delimited names
                  is produced.  This option is most useful when redirected
                  as input to another program (-n not required).

         -n       No color.  Screen color is disabled.  This option MUST be
                  used whenever the output is to redirected to a device
                  other than the console (not required with option -m).

         -o       List in directory order (unsorted).

         -p       List directory names with a trailing slash (/).

         -q       Replace unprintable name characters with a '?'.
                  Unprintable characters are considered to be all control
                  characters (0x00 - 0x1F) and the DEL character (0x7F).

         -r       Reverse the order of the selected sort (when sorted by
                  name the names will be sorted into reverse alphabetical
                  order, when sorted by the time/date stamp the oldest
                  files will come first).

         -s       Display the files in K-bytes (actually 1000 bytes) when
                  using options -1, -C, and -x.

         -t       Sort by the time/date stamp (the default is sorted by
                  name).  The newest files will be listed first.

         -x       List names in multiple columns, sorted across the
                  columns (the sequence is read like a book).

         -z       Don't pause after each screenfull.


    


    EXAMPLES

         Display a multi-column listing sorted by name, read down the
         columns (this is the default):

                  ls [Enter]

         Display a long list of the current directory:

                  ls -l [Enter]

         Display a one column listing of the files and directories within
         the UTIL directory on drive C:

                  ls -1 c:\util [Enter]

         Display a detailed (long) listing with the oldest files first:

                  ls -ltr [Enter]

         Display a detailed listing of all executable files in the current
         directory in reversed name order:

                  ls -lr *.exe *.com *.bat [Enter]



    NOTES

         DEFAULTS

         The names of the files and directories in the current directory
         are listed in ascending ASCII order.  The sequence reads down the
         columns.  No information other than the name is displayed.  Hidden
         and system files are not displayed. The listing  is color coded.
         LS_COLOR pauses after each screenfull.

         HINT

         The display format most similar to the DIR command is:

                  ls -l [Enter]

         UNIX ls:

         While LS_COLOR is very similar to the UNIX "ls" program, it is not
         intended to be identical.  Probably the most notable differences
         concern the treatment of wild cards (e.g. - d*.* is required to
         match all entries rather than d*) and the treatment of directories
         (the contents of a directory are not listed unless the name of the
         directory is explicitly given on the command line).  In these two
         cases LS_COLOR acts more like the MSDOS command "dir".  I have
         attempted to keep the listing formats identical to "ls" and in
         most cases the same switches are used to invoke the corresponding
         options (I couldn't resist using option -f to invoke the files
         only option).  Some obvious differences are the use of color and
         displaying directory names in uppercase.

         -s OPTION:

         When using the -s option the file size is divided by 1000 even
         though the on-screen indication is 'K'.  If someone has need for
         the size to actually be the file size divided by 1024, contact me
         at the e-mail address listed below.

         MODE INDICATOR EXPLANATION - [dsharwx]:

         d        directory
         s        system file
         h        hidden file
         a        archive flag is on
         r        the entry is readable (all entries for MSDOS)
         w        the entry may be written to (it isn't read-only)
         x        executable file


         COLOR CODE EXPLANATION:

         PLEASE NOTE: Color must be disabled (option -n) whenever the
         output destination is other than the console.

         The following groups are color coded to make file location easier:

         green       -  directories
         light cyan  -  executable files (.exe, .com, .bat)
         brown       -  .txt and .doc files
         light red   -  .c, .cpp and .h files
         red         -  .asm files
         dark gray   -  .obj files
         yellow      -  .bas files
         blue        -  .pas and .tpu files

         If you need some other group to be color coded contact me at the
         e-mail  address given below.

         BUG REPORTS

         Please report any bugs or other comments to:

                  Jerry Bundy
                  jbundy@netcom.com