.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.