aboutsummaryrefslogtreecommitdiff
path: root/binutils
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2013-08-23 13:37:06 +0000
committerNick Clifton <nickc@redhat.com>2013-08-23 13:37:06 +0000
commitce0570c764fd51d695d2c7601edd3b5fa40678c2 (patch)
tree34e6b5ca569e7504eb92e0013a2aff2c56b07cf3 /binutils
parent00d8452480aad3dbab5d660b242cffb27d45ce8f (diff)
downloadfsf-binutils-gdb-ce0570c764fd51d695d2c7601edd3b5fa40678c2.zip
fsf-binutils-gdb-ce0570c764fd51d695d2c7601edd3b5fa40678c2.tar.gz
fsf-binutils-gdb-ce0570c764fd51d695d2c7601edd3b5fa40678c2.tar.bz2
PR binutils/15798
* doc/binutils.texi (ar cmdline): Update description of 'q' command.
Diffstat (limited to 'binutils')
-rw-r--r--binutils/ChangeLog6
-rw-r--r--binutils/doc/binutils.texi15
2 files changed, 15 insertions, 6 deletions
diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index 6d425f2..af26997 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,9 @@
+2013-08-23 Nick Clifton <nickc@redhat.com>
+
+ PR binutils/15798
+ * doc/binutils.texi (ar cmdline): Update description of 'q'
+ command.
+
2013-08-23 Yuri Chornoivan <yurchor@ukr.net>
PR binutils/15834
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 4913adc..0c4bd5c 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -325,12 +325,15 @@ operation; new members are always placed at the end of the archive.
The modifier @samp{v} makes @command{ar} list each file as it is appended.
-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
-@command{ranlib} explicitly to update the symbol table index.
-
-However, too many different systems assume quick append rebuilds the
-index, so @sc{gnu} @command{ar} implements @samp{q} as a synonym for @samp{r}.
+Since the point of this operation is speed, implementations of
+@command{ar} have the option of not updating the archive's symbol
+table if one exists. Too many different systems however assume that
+symbol tables are always up-to-date, so @sc{gnu} @command{ar} will
+rebuild the table even with a quick append.
+
+Note - @sc{gnu} @command{ar} treats the command @samp {qs} as a
+synonym for @samp{r} - replacing already existing files in the
+archive and appending new ones at the end.
@item r
@cindex replacement in archive