aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2017-12-15 18:55:39 +0000
committerNick Clifton <nickc@redhat.com>2017-12-15 18:55:39 +0000
commitfc076a47fd716ca75447d432251abc67a19ef908 (patch)
treea3a7e026381157d235978831399a6b97a9a4a354
parent68f81d60196eb201b209873cf53258f13b0046b9 (diff)
downloadgdb-fc076a47fd716ca75447d432251abc67a19ef908.zip
gdb-fc076a47fd716ca75447d432251abc67a19ef908.tar.gz
gdb-fc076a47fd716ca75447d432251abc67a19ef908.tar.bz2
Update documentation regarding the bfd returned by bfd_openr_next_archived_file
PR 22571 * archive.c (bfd_openr_next_archived_file): Extend the documentation to note that it is necessary to call bfd_check_format on the rrturned bfd before using it.
-rw-r--r--bfd/ChangeLog7
-rw-r--r--bfd/archive.c9
2 files changed, 12 insertions, 4 deletions
diff --git a/bfd/ChangeLog b/bfd/ChangeLog
index debd663..4d4b10f 100644
--- a/bfd/ChangeLog
+++ b/bfd/ChangeLog
@@ -1,3 +1,10 @@
+2017-12-15 Nick Clifton <nickc@redhat.com>
+
+ PR 22571
+ * archive.c (bfd_openr_next_archived_file): Extend the
+ documentation to note that it is necessary to call
+ bfd_check_format on the rrturned bfd before using it.
+
2017-12-14 Nick Clifton <nickc@redhat.com>
* cpu-mt.c: Update address of FSF in copyright notice.
diff --git a/bfd/archive.c b/bfd/archive.c
index 021ed8b..a0ffb7b 100644
--- a/bfd/archive.c
+++ b/bfd/archive.c
@@ -764,10 +764,11 @@ SYNOPSIS
DESCRIPTION
Provided a BFD, @var{archive}, containing an archive and NULL, open
an input BFD on the first contained element and returns that.
- Subsequent calls should pass
- the archive and the previous return value to return a created
- BFD to the next contained element. NULL is returned when there
- are no more.
+ Subsequent calls should pass the archive and the previous return
+ value to return a created BFD to the next contained element. NULL
+ is returned when there are no more.
+ Note - if you want to process the bfd returned by this call be
+ sure to call bfd_check_format() on it first.
*/
bfd *