From 27e0fef5afde5a753efbb16d2727a11640825e71 Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Wed, 1 Apr 1998 20:57:21 +0000 Subject: [PATCH] From Zack Weinberg and H.J. Lu : * ar.c (usage): Mention S modifier. (main): Add S modifier. * ar.1, binutils.texi: Document S modifier. --- binutils/ar.1 | 24 +++++++++++++++++++++++- binutils/binutils.texi | 12 ++++++++++-- 2 files changed, 33 insertions(+), 3 deletions(-) diff --git a/binutils/ar.1 b/binutils/ar.1 index a138e4ac061..e4e8cff8134 100644 --- 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 diff --git a/binutils/binutils.texi b/binutils/binutils.texi index 040df8ff0f7..ff6ecd3a773 100644 --- a/binutils/binutils.texi +++ b/binutils/binutils.texi @@ -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 -- 2.30.2