add/re-enable at_wini debug output
[minix3.git] / man / man1 / ar.1
blob4ec53188c4e5189c473198df42f595359275a308
1 .TH AR 1
2 .SH NAME
3 ar, aal \- archivers
4 .SH SYNOPSIS
5 \fBar\fR [\fBdmpqrtx\fR][\fBabciluv\fR]\fR [\fIposname\fR] \fIarchive\fR [\fIfile \fR...]\fR
6 .br
7 \fBaal\fR [\fBdpqrtx\fR][\fBclv\fR]\fR \fIarchive\fR [\fIfile \fR...]\fR
8 .br
9 .de FL
10 .TP
11 \\fB\\$1\\fR
12 \\$2
14 .de EX
15 .TP 20
16 \\fB\\$1\\fR
17 # \\$2
19 .SH EXAMPLES
20 .EX "ar r libc.a sort.s" "Replace \fIsort\fR.s in \fIlibc.a\fR"
21 .EX "ar rb a.s libc.a b.s" "Insert \fIb.s\fR before \fIa.s\fR in \fIlibc.a\fR"
22 .SH DESCRIPTION
23 .PP
24 \fIAr\fR allows groups of files to be put together into a single archive.
25 It is normally used for libraries of compiled procedures.  \fIAal\fR is like
26 \fIar\fP, but is to be used with the ACK compiler.  The following keys
27 are allowed:
28 .PP
29 .ta 0.25i 0.50i
30 .nf
31         \fBd\fR:        Delete. \fIAr\fR will delete the named members.
32         \fBm\fR:        Move named files. \fIAr\fR expects \fIa\fR, \fIb\fR, or \fIi\fR to be specified.
33         \fBp\fR:        Print the named files (list them on \fIstdout\fR)
34         \fBq\fR:        Quickly append to the end of the archive file.
35         \fBr\fR:        Replace (append when not in archive).
36         \fBt\fR:        Print the archive's table of contents.
37         \fBx\fR:        Extract
38 .fi
39 .PP
40 \fBThe keys may optionally concatencated with one or more of the following\fR:
41 .nf
42 .PP
43         \fBa\fR:        After \fIposname\fR
44         \fBb\fR:        Before \fIposname\fR
45         \fBc\fR:        Create  (suppresses creation message)
46         \fBi\fR:        Before \fIposname\fR
47         \fBl\fR:        Local temporary file for work instead of \fI/tmp/ar.$$$$$\fR
48         \fBu\fR:        Replace only if dated later than member in archive
49         \fBv\fR:        Verbose
50 .PP
51 .fi
52 .SH "SEE ALSO"
53 .BR anm (1),
54 .BR asize (1),
55 .BR nm (1),
56 .BR size (1).