**********************************************************************
*                             LS                                     *
**********************************************************************
*                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
**********************************************************************
PROGRAM:
    LS - Expand and generate list of file names.
    
USAGE:
    LS afn ... [>fid]
    
FUNCTION:
    Expands file names that appear on the command line. It 
    automatically expands the parameter list to contain all files 
    that fit the afn's.

    An afn preceded by a "!" causes all names matching the given afn 
    to be EXCLUDED from the resulting expansion list. Thus, to yield 
    a command line containing all files except "COM" files, you'd say:

    A>LS !*.com <cr>

    Another example: to get all files on B: except .C files, say:

    A>LS b:*.* !b:*.c <cr>

    When giving a "!" afn, "*" chars in the string matches to the end 
    of either the filename or extension, just like CP/M, but "?" 
    chars match ONE and ONLY ONE character in either the filename or 
    extension.

EXAMPLE:
    LS *.HLP !HELP.HLP |PAGE |2UP -N4  >LST:
    
COMMENTS:
    No input is used except from the command line.
    


        Command Line                       

___________________________________  
                                  |  
                                  |  
                                  |  AMBIGUOUS FILE NAME LIST
                                  |  
                                  |                  
                    ______________V______________    
                    |                           |   Standard Output
                    |                           |   FILE NAME LIST
                    |            LS             |----------------------->
                    |                           |
                    |                           |
                    |___________________________|