util/arch/aal.1

   1 .\" $Id: aal.1,v 1.7 1994/06/24 10:14:11 ceriel Exp $
   2 .TH AAL 1 "$Revision: 1.7 $"
   3 .ad
   4 .SH NAME
   5 aal \- archive and library maintainer
   6 .SH SYNOPSIS
   7 .B aal
   8 key afile name ...
   9 .SH DESCRIPTION
  10 .I Aal
  11 maintains groups of ACK-object files
  12 combined into a single archive file.
  13 An index-table is automatically maintained.
  14 The link editor
  15 .IR led (6)
  16 only understands archives made with
  17 .IR aal .
  18 .PP
  19 .I Key
  20 is one character from the set
  21 .B qdrtx,
  22 optionally concatenated with
  23 one or more of
  24 .B vlc.
  25 .I Afile
  26 is the archive file.
  27 The
  28 .I names
  29 are constituent files in the archive file.
  30 The meanings of the
  31 .I key
  32 characters are:
  33 .TP
  34 .B d
  35 Delete the named files from the archive file.
  36 .TP
  37 .B q
  38 Append the named files to the archive file.
  39 .TP
  40 .B r
  41 Replace the named files in the archive file.
  42 New files are placed at the end.
  43 .TP
  44 .B t
  45 Print a table of contents of the archive file.
  46 If no names are given, all files in the archive are listed.
  47 If names are given, only those files are listed.
  48 .TP
  49 .B x
  50 Extract the named files.
  51 If no names are given, all files in the archive are
  52 extracted.
  53 In neither case does
  54 .B x
  55 alter the archive file.
  56 .TP
  57 .B v
  58 Verbose.
  59 Under the verbose option,
  60 .I aal
  61 gives a file-by-file
  62 description of the making of a
  63 new archive file from the old archive and the constituent files.
  64 When used with
  65 .B t,
  66 it gives a long listing of all information about the files.
  67 .TP
  68 .B l
  69 Local.
  70 Normally
  71 .I aal
  72 places its temporary files in the directory /tmp.
  73 This option causes them to be placed in the local directory.
  74 .TP
  75 .B c
  76 Create. Normally
  77 .I aal
  78 will create
  79 .I afile
  80 when it needs to.
  81 The create option supresses the normal message that is produced when
  82 .I afile
  83 is created.
  84 .SH FILES
  85 /tmp/ar.* temporaries
  86 .SH "SEE ALSO"
  87 led(6), arch(5),
  88 .SH BUGS
  89 If the same file is mentioned twice in an argument list,
  90 it may be put in the archive twice.