ack/util/arch/aal.1

.\" $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 vlc.
.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.
.TP
.B c
Create. Normally
.I aal
will create
.I afile
when it needs to.
The create option supresses the normal message that is produced when
.I afile
is created.
.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.