Initial revision

util/arch/aal.1

@@ -0,0 +1,79 @@
+.\" $Header$
+.TH ARCH 1ACK
+.SH NAME
+aal \- archive and library maintainer
+.SH SYNOPSIS
+.B aal
+key afile name ...
+.SH DESCRIPTION
+.I Aal
+maintains groups of ACK-object files
+combined into a single archive file.
+An index-table is automatically maintained.
+The link editor
+.IR led (6)
+only understands archives made with
+.IR aal .
+.PP
+.I Key
+is one character from the set
+.B adrtx,
+optionally concatenated with
+one or more of
+.B vl.
+.I Afile
+is the archive file.
+The
+.I names
+are constituent files in the archive file.
+The meanings of the
+.I key
+characters are:
+.TP
+.B d
+Delete the named files from the archive file.
+.TP
+.B a
+Append the named files to the archive file.
+.TP
+.B r
+Replace the named files in the archive file.
+New files are placed at the end.
+.TP
+.B t
+Print a table of contents of the archive file.
+If no names are given, all files in the archive are listed.
+If names are given, only those files are listed.
+.TP
+.B x
+Extract the named files.
+If no names are given, all files in the archive are
+extracted.
+In neither case does
+.B x
+alter the archive file.
+.TP
+.B v
+Verbose.
+Under the verbose option,
+.I aal
+gives a file-by-file
+description of the making of a
+new archive file from the old archive and the constituent files.
+When used with
+.B t,
+it gives a long listing of all information about the files.
+.TP
+.B l
+Local.
+Normally
+.I aal
+places its temporary files in the directory /tmp.
+This option causes them to be placed in the local directory.
+.SH FILES
+/tmp/ar.* temporaries
+.SH "SEE ALSO"
+em_ass(I), arch(V),
+.SH BUGS
+If the same file is mentioned twice in an argument list,
+it may be put in the archive twice.