PR17074 - ignore line terminator characters found inside strings.

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

diff --git a/binutils/ar.1 b/binutils/ar.1
index fac6223bbf7839d291d1f3b1c50e884e0229449a..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
@@ -465,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