From ce0570c764fd51d695d2c7601edd3b5fa40678c2 Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Fri, 23 Aug 2013 13:37:06 +0000 Subject: [PATCH] PR binutils/15798 * doc/binutils.texi (ar cmdline): Update description of 'q' command. --- binutils/ChangeLog | 6 ++++++ binutils/doc/binutils.texi | 13 ++++++++----- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/binutils/ChangeLog b/binutils/ChangeLog index 6d425f26cc..af2699716f 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,3 +1,9 @@ +2013-08-23 Nick Clifton + + PR binutils/15798 + * doc/binutils.texi (ar cmdline): Update description of 'q' + command. + 2013-08-23 Yuri Chornoivan PR binutils/15834 diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index 4913adca92..0c4bd5c22c 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. +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. -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}. +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