.tl 'LIBR(I)'12/17/75'LIBR(I)'
libr libfile -k1 n11 n12 ... n1k ... -kn ...
LIBR is a program to build and maintain libraries of object modules
to be used with LINK. An object module in a library is included in the out file
iff it satisfies an undefined reference at the time it is encountered. (With some
exceptions for -i: and -e: ) Therefore, the order of modules in a library is
All commands except append (-a ) require that the file designated 'libfile'
already exit. The append command will create the library file if it does
not exist. The action of LIBR is governed by the keybytes, which are
interpreted in left-to-right order. The entire command line is checked for
correctness, and then executed.
In a library, all modules are identifies by their module name.
Assembly language programs get their module name from a .title directive.
In fortran subprograms the module name is the name of the subroutine declared
There are no default extensions.
list the contents of the library as it will appear at the completion
As noted above, a module is included into an outfile from a library only if
it 'declares' a yet-undefined global symbol. Initially, a module declares
all those global symbols which are assigned values within it.
The -g command allows one to eliminate declarations from a module.
delete the named modules from the library
place the modules in the named files into the library before the
Replace the modules in the library with those in the files having the
Append the modules in the named files to the library. Create the library if it does
Generate a cross-reference
A fortran user wants to create a library of six graphics
subroutines in the object files graph1.obj ... graph6.obj.
First, a library is created:
libr graphlib -a graph1.obj ... graph6.obj
If, later, it is necessary to replace one of the subroutines, say #4,
libr graphlib -r graph4.obj