The ARM Librarian (armlib)
--------------------------


About armlib
............

The ARM Librarian allows sets of related AOF files to be collected together, 
and for  these libraries to be maintained.  Such a  library can then be passed 
to the linker instead of several AOF files.  

However, linking with an object library file does not necessarily produce the 
same results as linking with all the object files collected into the object 
library file.  This is due to the way <armlink> processes its input files:

 *  each object file in the input list appears in the output unconditionally 
    (although  unused areas will be eliminated if the output is AIF or if the 
    -NOUNUSEDareas option is specified);

 *  a module from a libray file is only included in the output if an object 
    file, or previously processed library file refers to it.

For more information on how <armlink> processes its input files refer to "<Area 
Placement and Sorting Rules>" of the Reference Manual.

The full specification of ARM Object Library Format can be found in chapter "
<ARM Object Library Format>" of the Technical 
Specifications.


Command Line Options
....................

The format of the armlib command is:

    armlib <option>s <library> [<file>-list | <member-lis>t]

The wildcards '*' and '?' may be used in  <file-list> and <member-list>.

<options> can be any of the following:

    -h or -help give on-line details of the armlib command;

    -c          create a new library containing files in <file-list>;

    -i          insert files in <file-list> into the library.  Existing members 
                of the library are replaced by mermbers of the same name;

    -d          delete members in <member-list>

    -e          extract members in <member-list>, placing them  in files of the 
                same name;

    -o          add an external symbol table to an object library;

    -l          list library.  This may be specified together with any other 
                option;

    -s          list symbol table.  This may be specified together with any 
                other option;\

    -v <file>   Additional arguments are read in from a via file, in the same 
                way as the armlink -via option.

