**********************************************************************
*                               NUM                                  *
**********************************************************************
*                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
**********************************************************************
PROGRAM:
    NUM - Concatenate named files together to produce a line numbered 
    output.
USAGE:
    NUM [<fid] afn ... [>fid]
FUNCTION:
    This can act either as a filter or a source.  If the command line
    contains filenames, these files are read, concatenated, and 
    prefixed with a line number.  Afn's may be used for these 
    file names.
    
    If there is directed input, either from a pipe or from a file, 
    this input is concatenated at the end of any of the files 
    obtained from the command line specifications.  Under no 
    circumstances will this program accept input from the normal 
    keyboard input path.  This allows it to be used as a simple 
    source when no directed input is used.
    
EXAMPLE:
    NUM *.HLP
    NUM F1 F2 F3 >FALL
    NUM <FILELIST >ALLLINES    


        Command Line                       

___________________________________  
                                  |  
                                  |  
                                  |  AMBIGUOUS FILE NAME LIST
                                  |  
                                  |                  
                    ______________V______________    
 Standard Input     |                           |    Standard Output
     TEXT           |                           |   TEXT WITH NUMBERS
------------------->|            NUM            |----------------------->
                    |                           |
                    |                           |
                    |___________________________|
