Mon Nov 9 12:00:36 1998 Dave Brolley <brolley@cygnus.com>

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

diff --git a/binutils/ar.1 b/binutils/ar.1
index a138e4ac061cd2944c57addd1e24588d550fc0c5..e4e8cff8134ad27bf56f1e9986fca72c688309d1 100644 (file)
--- a/binutils/ar.1
+++ b/binutils/ar.1
@@ -14,7 +14,7 @@ ar \- create, modify, and extract from archives.
 .hy 0
 .na
 .BR ar " [\|" "-" "\|]"\c
-.I {dmpqrtx}[abcilosuvV] \c
+.I {dmpqrtx}[abcilosSuvV] \c
 [\|\c
 .I membername\c
 \&\|] \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
@@ -415,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