.np
.rm 71
.m2 0
     This command simplifies basic processing of Library Archive files.
A Library Archive file may contain several hundred
VAX files stacked together end-to-end to conserve disk space.
The basic processing options are:
.sp
.nf
.in +1
-CREATE  - (or "-C") Create a Library Archive File named "library-name".
-LIST    - (or "-L") List the file index of a Library Archive File.
-INSERT  - (or "-I:file-spec") Insert specified files into a Library.
-EXTRACT - (or "-E[:file-id]") Extract a specified file, or all stored
                               files, to be returned to original form.
-SQUEEZE - (or "-S") Squeeze a Library to free unused space.
.sp
.in -1
.fi
If "library-name" is omitted, "LIBRARY.ARC" is assumed.
The default file type is ".ARC".
.sp
All files inserted into a Library Archive File are stored with their
file-name and file-type specifiers only
(version numbers and directory names are omitted).
Also, the "file-spec" may contain any qualifiers recognized by the
VAX "DIRECTORY" command, including wildcard characters,
"/BEFORE", "/SINCE", "/EXCLUDE", etc.
.br
Each file inserted into a Library will replace any earlier file of the
same name.
When a file is replaced, it produces a section of empty deleted
blocks.  This unused space can be eliminated by using the
"-SQUEEZE" option, which creates a new compressed version
of the Library Archive File.
.sp
     An individual file may be extracted from a Library by
using the "-EXTRACT" option with "file-id".  If the "file-id"
is omitted, all stored files will be extracted.
.sp
The "-LIST" option can save a Library index listing in a disk file
if the "-OUT" option is used.
.br
The Library Archive files are manipulated as VAX/VMS text libraries
using the VAX Command "LIBRARY/TEXT".
For more information about processing text libraries,
see "HELP LIBRARY".
.sp
.nf
Examples:
.sp
.in +1
ARCHIVE -CREATE source.lib   <-- Create a Library named "source.lib"
ARC -INSERT:*.FOR source.lib <-- Insert FORTRAN source files into Library
AR -C                        <-- Create a Library named "LIBRARY.ARC"
AR -I                        <-- Insert FLECS and/or FORTRAN files
AR -L                        <-- List file index of "LIBRARY.ARC"
AR -E                        <-- Extract files to their original form
AR -I:"/SINCE *.FOR"         <-- Insert (replace) files modified today
AR -I:"/EXCL=*TEST*.* *.FOR" <-- Insert FORTRAN; exclude test files
AR -E:PROGX.FOR              <-- Extract one file by name
