util/arch/arch.1

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