new files -- part of HP merge.
[deliverable/binutils-gdb.git] / binutils / ar.1
index 1e19390846b836fba9fa0498125da1e599e2b0c0..e4e8cff8134ad27bf56f1e9986fca72c688309d1 100644 (file)
@@ -8,13 +8,13 @@
 ..
 
 .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
@@ -79,7 +79,7 @@ their placement in the archive.
 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
@@ -215,6 +215,15 @@ index is not updated, even if it already existed; you can use `\|\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
@@ -363,6 +372,18 @@ created if it didn't exist, when you request an update.  But a warning is
 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
@@ -403,6 +424,19 @@ archive is equivalent to running `\|\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
@@ -435,6 +469,11 @@ when the modifier `\|\c
 .B v\c
 \|' is appended.
 
+.TP
+.B V
+This modifier shows the version number of
+.BR ar .
+
 .PP
 
 .SH "SEE ALSO"
@@ -448,7 +487,7 @@ The GNU Binary Utilities\c
 , Roland H. Pesch (October 1991).
 .BR nm ( 1 )\c
 \&,
-.BR ranlib( 1 )\c
+.BR ranlib ( 1 )\c
 \&.
 
 .SH COPYING
This page took 0.023946 seconds and 4 git commands to generate.