document --disassembler-options=force-thumb

[deliverable/binutils-gdb.git] / binutils / ar.1

diff --git a/binutils/ar.1 b/binutils/ar.1
index 93d87778c580fb28e691a356ac8a139d6847ba4c..cd71a407b3710615ef9e59eb615d11b21764791f 100644 (file)
--- a/binutils/ar.1
+++ b/binutils/ar.1
@@ -1,6 +1,6 @@
-.\" Copyright (c) 1991 Free Software Foundation
+.\" Copyright (c) 1991, 1992, 1993, 1995, 1998, 1999 Free Software Foundation
 .\" See section COPYING for conditions for redistribution
-.TH ar 1 "5 November 1991" "cygnus support" "GNU Development Tools"
+.TH ar 1 "1999" "Cygnus Solutions" "GNU Development Tools"
 .de BP
 .sp
 .ti \-.2i
@@ -14,10 +14,13 @@ ar \- create, modify, and extract from archives.
 .hy 0
 .na
 .BR ar " [\|" "-" "\|]"\c
-.I {dmpqrtx}[abcilosuvV] \c
+.I {dmpqrtx}[abcfilNoPsSuvV] \c
 [\|\c
 .I membername\c
 \&\|] \c
+[\|\c
+.I count\c
+\&\|] \c
 .I archive\c
 \& \c
 .I files\c
@@ -215,6 +218,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 +375,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
@@ -384,6 +408,15 @@ member must be present as the \c
 .B l
 This modifier is accepted but not used.
 
+.TP
+.B N
+Uses the
+.I count
+parameter.  This is used if there are multiple entries in the archive
+with the same name.  Extract or delete instance
+.I count
+of the given name from the archive.
+
 .TP
 .B o
 Preserve the \c
@@ -392,6 +425,18 @@ Preserve the \c
 you do not specify this modifier, files extracted from the archive
 will be stamped with the time of extraction.
 
+.TP
+.B P
+Use the full path name when matching names in the archive.
+.B ar
+can not create an archive with a full path name (such archives are not
+POSIX complaint), but other archive creators can.  This option will
+cause
+.B ar
+to match file names using a complete path name, which can be
+convenient when extracting a single file from an archive created by
+another tool.
+
 .TP
 .B s
 Write an object-file index into the archive, or update an existing one,
@@ -403,6 +448,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
@@ -453,11 +511,11 @@ The GNU Binary Utilities\c
 , Roland H. Pesch (October 1991).
 .BR nm ( 1 )\c
 \&,
-.BR ranlib( 1 )\c
+.BR ranlib ( 1 )\c
 \&.
 
 .SH COPYING
-Copyright (c) 1991 Free Software Foundation, Inc.
+Copyright (c) 1991, 1992, 1993, 1995, 1998, 1999 Free Software Foundation, Inc.
 .PP
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice