

     ASPLIT                         8/25/80                          ASPLIT


     NAME
        
        asplit - salvage garbaged archive files
        
     SYNOPSIS
        
        asplit <file [-tstring] [-v]
        
     DESCRIPTION
        
        asplit  reads  the standard input file, looking for lines beginning
        with the archive header flag (#-h-).  Upon locating  such  a  line,
        the next word after the header is used to generate a file name, and
        all  lines  read up to the next pseudo-header line are written onto
        that file.  When generating the  file  name,  only  the  characters
        found  before a left parenthesis are used, if one is found.  If the
        -t switch is used, the string appended to the  -t  is  appended  to
        each  file  name before the file is opened, thus permitting a fixed
        tag string to be formatted into the file name.  If the -v option is
        specified, the name of each file is reported on  ERROUT  as  it  is
        opened.  Any  lines  found  at the beginning of the file before the
        first pseudo-header line is copied to standard output.
        
        asplit is commonly used  to  salvage  an  archive  which  has  been
        garbaged,  or  to  take  a  monster fortran source program file and
        break it up into subroutines. A script file (breakup) may be  found
        on  the  tools binary directory which will cause each subprogram of
        the form "subroutine snarf" or "... function snarf" to be placed on
        a file of the name  "snarf.qq".   The  only  side  effect  of  this
        transformation is that the source will be in lower case, and may be
        remedied by modifying the file breakup.
        
     FILES
        
        none
        
     SEE ALSO
        
        ar  -  file archiver: the -s switch does essentially the same thing
        as asplit, except that it tries to rebuild the source file as a new
        archive, which does not always work in pathological cases.
        
     AUTHOR
        
        asplit was written by Joe Sventek
        
     BUGS/DEFICIENCIES






                                      -1-                                  

