From Zack Weinberg <zack@rabi.phys.columbia.edu> and H.J. Lu

<hjl@gnu.org>:
	* ar.c (usage): Mention S modifier.
	(main): Add S modifier.
	* ar.1, binutils.texi: Document S modifier.
This commit is contained in:
Ian Lance Taylor 1998-04-01 20:57:21 +00:00
parent 91852c944d
commit 27e0fef5af
2 changed files with 33 additions and 3 deletions

View File

@ -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

View File

@ -279,8 +279,8 @@ Since the point of this operation is speed, the archive's symbol table
index is not updated, even if it already existed; you can use @samp{ar s} or
@code{ranlib} explicitly to update the symbol table index.
However, too many different system assume quick append rebuilds the
index, so GNU ar treats @code{q} to same way its treats @code{r}.
However, too many different systems assume quick append rebuilds the
index, so GNU ar implements @code{q} as a synonym for @code{r}.
@item r
@cindex replacement in archive
@ -388,6 +388,14 @@ even if no other change is made to the archive. You may use this modifier
flag either with any operation, or alone. Running @samp{ar s} on an
archive is equivalent to running @samp{ranlib} on it.
@item S
@cindex not writing archive index
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
@samp{S} modifier on the last execution of @samp{ar}, or you must run
@samp{ranlib} on the archive.
@item u
@cindex updating an archive
Normally, @samp{ar r}@dots{} inserts all files