.pa 1
.he 'AR (I)'3/15/72'AR (I)'
.ti 0
NAME		ar -- archive
.sp
.ti 0
SYNOPSIS	ar__ key afile name918 ...
.sp
.ti 0
DESCRIPTION	ar__
maintains groups of files
combined into a single archive file.
Its main use
is to create and update library files as used by the loader.
It can be used, though, for any similar purpose.
.sp
key___ is one character from the set drtux_____,
optionally concatenated with v_.
afile_____ is the archive file.
The names_____ are constituent files in the archive file.
The meanings of the key___ characters are:
.sp
d_ means delete the named files from the archive file.
.sp
r_ means replace the named files in the archive file.
If the archive file does not exist, r_ will create it.
If the named files are not in the archive file, they are appended.
.sp
t_ prints a table of contents of the archive file.
If no names are given, all files in the archive are tabled.
If names are given, only those files are tabled.
.sp
u_ is similar to r_ except that only those
files that have been modified are replaced.
If no names are given, all files in the archive that
have been modified will be replaced by the modified version.
.sp
x_ will extract the named files.
If no names are given, all files in the archive are
extracted.
In neither case does x_ alter the archive file.
.sp
v_ means verbose.
Under the verbose option,
ar__ gives a file-by-file
description of the making of a
new archive file from the old archive and the constituent files.
The following abbreviations
are used:
.sp
   c_ copy
   a_ append
   d_ delete
   r_ replace
   x_ extract
.sp
.ti 0
FILES		/tmp/vtm?	 temporary
.sp
.ti 0
SEE ALSO	ld(I), archive(V)
.sp
.ti 0
DIAGNOSTICS	"Bad usage",
"afile -- not in archive format",
"cannot open temp file",
"name -- cannot open",
"name -- phase error",
"name -- cannot create",
"no archive file",
"cannot create archive file",
"name -- not found".
.sp
.ti 0
BUGS		Option
vt__ should be implemented as a table with more information.
.sp
There should be a way to specify the placement
of a new file in an archive.
Currently, it is placed at the end.

"ar x" changes the modified-date of the current
directory to a random number.
