
NAME
          Libr -- Librarian for Macro and Linker

SYNOPSIS
          libr libfile -s1 arg11 ... arg1n -s2 ... -sn .... argnn

     or:

          libr  @cclfile


DESCRIPTION

          LIBR  is  the  counterpart of ar and nar, but for macro
and linker.  It is used to build and  maintain  libraries  to  be
used  with  linker.  An object module in a library is included in
the .out file iff it satisfies and  undefined  reference  at  the
time  it  is encountered.  Note that the order of the switches is
important,and that all switches may be abbreviated.

          All commands except append require that the file desig-
nated 'libfile' already exist. The append command will create the
library file if necessary. The action of LIBR is governed by  the
switches,  which  are  interpreted in left-to-right order. If the
second form of the command is used,  the  contents  of  the  file
specified  is taken to be the action control line. The libfile is
overwriten only after the entire command string is executed.

          In a library, all modules are identified by their modu-
le name.  Assembly language programs get their module name from a
.title directive.  In a fortran subprogram, the module name is he
name of the subroutine or function it defines.

          The  default  extention is .obj; if a file name is sup-
plied with no extention ( this means that between the  final  '/'
of the filename [or the beginning of the filename if there are no
'/'s] and the end of the file name, there  exist  no  '.'s),  the
file  file.obj  is  assumed; if this file doesn't exist, the ori-
ginal name itself is then used.

The switches are:

          -list              list the contents of the library  as
                              it currently is.

          -append files      Append  the  modules  in  the  named
                              files to the  library.  create  the
                              library if it does not exist.

          -replace files     Replace  the  modules in the library
                              that are also in  the  named  files
                              with those modules in the files.












          -delete mods      delete the  named  modules  from  the
                              library.

          -insert mod files  insert  the  modules  in  the  files
                              before the named module.

  Tmpfiles:

          LIBF1TMPxxxx

          LIBF2TMPxxxx

          LIBTEXtxxxx


   Restriction:

            Note  that  Libr does not support concatenated object
  files. Therefore, compile each Fortran subprogram  or  function
  that will live in a library in individual compilations.

       This  libr works only with linker, not to be confused with
  linkr, the original (and lame duck) linkage editor.
