Warn 'ar q' doesn't update archive ST index.

This commit is contained in:
Roland Pesch
1991-10-10 00:48:05 +00:00
parent dafcb8be38
commit 8706a92ce1

View File

@ -121,11 +121,11 @@ subroutines.
@code{ar} will create an index to the symbols defined in relocatable @code{ar} will create an index to the symbols defined in relocatable
object modules in the archive when you specify the modifier @samp{s}. object modules in the archive when you specify the modifier @samp{s}.
Once created, this index is updated in the archive whenever @code{ar} Once created, this index is updated in the archive whenever @code{ar}
makes a change to its contents. An archive with such an index speeds up makes a change to its contents (save for the @samp{q} update operation).
linking to the library, and allows routines in the library to call each An archive with such an index speeds up linking to the library, and
other without regard to their placement in the archive. allows routines in the library to call each other without regard to
@c FIXME This auto-update may happen-always only for WRS version; Gumby their placement in the archive.
@c says, for instance, that it doesn't happen with 'q' updates elsewhere.
You may use @samp{nm -s} or @samp{nm +print-armap} to list this index You may use @samp{nm -s} or @samp{nm +print-armap} to list this index
table. If an archive lacks the table, another form of @code{ar} called table. If an archive lacks the table, another form of @code{ar} called
@ -184,8 +184,9 @@ operation; new members are always placed at the end of the archive.
The modifier @samp{v} makes @code{ar} list each file as it is appended. The modifier @samp{v} makes @code{ar} list each file as it is appended.
@c FIXME: per Gumby, versions other than WRS of this will *not* auto-update Since the point of this operation is speed, the archive's symbol table
@c SYMDEF index on 'q' updates. 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.
@item r @item r
Insert @var{files} into @var{archive} (with @emph{replacement}). This Insert @var{files} into @var{archive} (with @emph{replacement}). This