aboutsummaryrefslogtreecommitdiff
path: root/binutils
diff options
context:
space:
mode:
authorRoland Pesch <pesch@cygnus>1991-10-08 20:59:54 +0000
committerRoland Pesch <pesch@cygnus>1991-10-08 20:59:54 +0000
commit050f05e73fadcf8513a1460d9fd71e4d7734cbd2 (patch)
tree0dd44b73278c0c31295b2a28c65816c5f8695cc7 /binutils
parenta6fe7eeb1e3e7bb5d094e3b672a5632d05121a35 (diff)
downloadgdb-050f05e73fadcf8513a1460d9fd71e4d7734cbd2.zip
gdb-050f05e73fadcf8513a1460d9fd71e4d7734cbd2.tar.gz
gdb-050f05e73fadcf8513a1460d9fd71e4d7734cbd2.tar.bz2
Tue Oct 8 13:58:59 1991 Roland H. Pesch (pesch at cygnus.com)
* binutils.texinfo: remove most remaining FIXME's, delete references to __.SYMDEF by name
Diffstat (limited to 'binutils')
-rw-r--r--binutils/ChangeLog6
-rwxr-xr-xbinutils/binutils.texinfo36
2 files changed, 19 insertions, 23 deletions
diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index a611810..b03727d 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,9 @@
+Tue Oct 8 13:58:59 1991 Roland H. Pesch (pesch at cygnus.com)
+
+ * binutils.texinfo: remove most remaining FIXME's, delete
+ references to __.SYMDEF by name
+
+
Tue Oct 8 10:23:44 1991 Steve Chamberlain (steve at cygnus.com)
* objdump.c (print_address) Print addresses nicely.
diff --git a/binutils/binutils.texinfo b/binutils/binutils.texinfo
index 59068d8..ef61e69 100755
--- a/binutils/binutils.texinfo
+++ b/binutils/binutils.texinfo
@@ -107,8 +107,12 @@ The original files' contents, mode (permissions), timestamp, owner, and
group are preserved in the archive, and may be reconstituted on
extraction.
-Only the first fifteen characters of a file name are kept in archives.
-@c FIXME: with BFD version, this depends on obj format.
+GNU @code{ar} can maintain archives whose members have names of any
+length; however, depending on how @code{ar} is configured on your
+system, a limit on member-name length may be imposed (for compatibility
+with archive formats maintained with other tools). If it exists, the
+limit is often 15 characters (typical of formats related to a.out) or 16
+characters (typical of formats related to coff).
@code{ar} is considered a binary utility because archives of this sort
are most often used as @dfn{libraries} holding commonly needed
@@ -149,10 +153,6 @@ any of the following, but you must specify only one of them:
be deleted as @var{files}; the archive is untouched if you
specify no files to delete.
-If you wish to delete an archive's index, you can use this option to do
-it; the internal name of the index (which you will need to specify in
-@var{files} to delete it) is @samp{__.SYMDEF}.
-
If you specify the @samp{v} option flag, @code{ar} will list each module
as it is deleted.
@@ -173,9 +173,7 @@ specified place instead.
output file. If the @samp{v} option flag is specified, show the member
name before copying its contents to standard output.
-If you specify no @var{files}, all the files in the archive are printed,
-save for the index (if any), which is listed only if you ask for it by
-name: @samp{__.SYMDEF}.
+If you specify no @var{files}, all the files in the archive are printed.
@item q
@emph{Quick append}; add @var{files} to the end of @var{archive},
@@ -215,9 +213,7 @@ see the modes (permissions), timestamp, owner, group, and size, you can
request that by also specifying the @samp{v} option flag.
If you do not specify any @var{files}, all files in the archive
-are listed; but the index to symbols from relocatable modules, called
-@samp{__.SYMDEF}, is not listed unless you explicitly request it by
-name.
+are listed.
If there is more than one file with the same name (say, @samp{fie}) in
an archive (say @samp{b.a}), @samp{ar t b.a fie} will list only the
@@ -232,10 +228,7 @@ use the @samp{v} option flag with this operation, to request that
@code{ar} list each name as it extracts it.
If you do not specify any @var{files}, all files in the archive
-are extracted; but the index to symbols from relocatable modules, called
-@samp{__.SYMDEF}, is not extracted unless you explicitly request it by
-name.
-@c FIXME: does __.SYMDEF appear in all BFD arch formats? If not, which?
+are extracted.
@end table
@@ -268,9 +261,9 @@ member must be present as the @var{membername} argument, before the
@var{archive} specification. (same as @samp{b}).
@item l
-This option flag is recognized but not used; it is permitted for
-compatibility with other forms of @code{ar}.
-@c FIXME ar l modifier???---pesch@@cygnus.com, 25jan91
+This option flag is accepted but not used.
+@c whaffor ar l modifier??? presumably compat; with
+@c what???---pesch@@cygnus.com, 25jan91
@item o
Preserve the @emph{original} dates of members when extracting them. If
@@ -349,7 +342,7 @@ names.
@item +print-armap
@itemx -s
When listing symbols from archives, list the index: a mapping (stored in
-the archive by @code{ar} or @code{ranlib} of what modules contain
+the archive by @code{ar} or @code{ranlib}) of what modules contain
definitions for what names.
@item +print-file-name
@@ -481,9 +474,6 @@ stores it in the archive. The index lists each symbol defined by a
member of an archive that is a relocatable object file.
You may use @code{nm -s} or @code{nm +print-armap} to list this table.
-The index is internally stored in the archive under the name
-@samp{__.SYMDEF}.
-@c FIXME does __.SYMDEF exist in archives in all flavors? (ranlib)
An archive with such an index speeds up linking to the library, and
allows routines in the library to call each other without regard to