..
.SH NAME
-ar\(em\&create, modify, and extract from archives.
+ar \- create, modify, and extract from archives.
.SH SYNOPSIS
.hy 0
.na
.BR ar " [\|" "-" "\|]"\c
-.I pmod \c
+.I {dmpqrtx}[abcilosSuvV] \c
[\|\c
.I membername\c
\&\|] \c
You may use `\|\c
.B nm \-s\c
\|' or `\|\c
-.B nm +print-armap\c
+.B nm \-\-print\-armap\c
\|' to list this index
table. If an archive lacks the table, another form of \c
.B ar\c
.B ranlib\c
\& explicitly to update the symbol table index.
+However, too many different systems assume quick append rebuilds the
+index, so GNU
+.B ar
+implements `\|\c
+.B q\c
+\|' as a synonym for `\|\c
+.B r\c
+\|'.
+
.TP
.B r
Insert \c
issued unless you specify in advance that you expect to create it, by
using this modifier.
+.TP
+.B f
+Truncate names in the archive.
+.B ar
+will normally permit file names of any length. This will cause it to
+create archives which are not compatible with the native
+.B ar
+program on some systems. If this is a concern, the
+.B f
+modifier may be used to truncate file names when putting them in the
+archive.
+
.TP
.B i
Insert new files \c
.B ranlib\c
\|' on it.
+.TP
+.B S
+Do not generate an archive symbol table. This can speed up building a
+large library in several steps. The resulting archive can not be used
+with the linker. In order to build a symbol table, you must omit the
+`\|\c
+.B S\c
+\|' modifier on the last execution of `\|\c
+.B ar\c
+\|', or you must run `\|\c
+.B ranlib\c
+\|' on the archive.
+
.TP
.B u
Normally, \c
.B v\c
\|' is appended.
+.TP
+.B V
+This modifier shows the version number of
+.BR ar .
+
.PP
.SH "SEE ALSO"
, Roland H. Pesch (October 1991).
.BR nm ( 1 )\c
\&,
-.BR ranlib( 1 )\c
+.BR ranlib ( 1 )\c
\&.
.SH COPYING