OpenE2K
/
binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
binutils/ar.1
View File

@ -14,7 +14,7 @@ ar \- create, modify, and extract from archives.
.hy 0 .hy 0
.na .na
.BR ar " [\|" "-" "\|]"\c .BR ar " [\|" "-" "\|]"\c
.I {dmpqrtx}[abcilosuvV] \c .I {dmpqrtx}[abcilosSuvV] \c
[\|\c [\|\c
.I membername\c .I membername\c
\&\|] \c \&\|] \c
@ -215,6 +215,15 @@ index is not updated, even if it already existed; you can use `\|\c
.B ranlib\c .B ranlib\c
\& explicitly to update the symbol table index. \& 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 .TP
.B r .B r
Insert \c Insert \c
@ -415,6 +424,19 @@ archive is equivalent to running `\|\c
.B ranlib\c .B ranlib\c
\|' on it. \|' 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 .TP
.B u .B u
Normally, \c Normally, \c

12
binutils/binutils.texi
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 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. @code{ranlib} explicitly to update the symbol table index.
However, too many different system assume quick append rebuilds the However, too many different systems assume quick append rebuilds the
index, so GNU ar treats @code{q} to same way its treats @code{r}. index, so GNU ar implements @code{q} as a synonym for @code{r}.
@item r @item r
@cindex replacement in archive @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 flag either with any operation, or alone. Running @samp{ar s} on an
archive is equivalent to running @samp{ranlib} on it. 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 @item u
@cindex updating an archive @cindex updating an archive
Normally, @samp{ar r}@dots{} inserts all files Normally, @samp{ar r}@dots{} inserts all files