libbfd.texi zero size

Pattern rules in doc/local.mk exist that specify how to make
libbfd.texi from libfd.h or libbfd.c.  Since both files exist and the
libbfd.h rule is first, libbfd.h is used.  libbfd.h doesn't contain
the documentation..

	* doc/local.mk (doc/%stamp): Put rule making this from %.c
	before %.h rule.
	* Makefile.in: Regenerate.
	* libbfd.c (Byte swapping routines): Don't omit description.

diff --git a/bfd/Makefile.in b/bfd/Makefile.in
index bb530271fca14c2fad92a293f3f29d6420624c35..f8bc859e6cfd2478873ad96428c9c997a68360aa 100644 (file)
--- a/bfd/Makefile.in
+++ b/bfd/Makefile.in
@@ -2489,10 +2489,10 @@ doc/chew.stamp: $(srcdir)/doc/chew.c doc/$(am__dirstamp)
 
 .PRECIOUS: doc/%.stamp
 doc/%.texi: doc/%.stamp ; @true
-doc/%.stamp: $(srcdir)/%.h $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp)
-       $(AM_V_GEN)$(REGEN_TEXI)
 doc/%.stamp: $(srcdir)/%.c $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp)
        $(AM_V_GEN)$(REGEN_TEXI)
+doc/%.stamp: $(srcdir)/%.h $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp)
+       $(AM_V_GEN)$(REGEN_TEXI)
 
 # Avoid the %.stamp generating a builddir/bfd.texi that overrides the
 # srcdir/ as well as regenerating doc/bfd.info for each make run.

diff --git a/bfd/doc/local.mk b/bfd/doc/local.mk
index d80f70416a3f1092b13973a88efc065df32c70dc..f602e7d947fdb73c3cf6d7fc1183941cf52a2db7 100644 (file)
--- a/bfd/doc/local.mk
+++ b/bfd/doc/local.mk
@@ -111,10 +111,10 @@ REGEN_TEXI = \
 
 .PRECIOUS: %D%/%.stamp
 %D%/%.texi: %D%/%.stamp ; @true
-%D%/%.stamp: $(srcdir)/%.h $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp)
-       $(AM_V_GEN)$(REGEN_TEXI)
 %D%/%.stamp: $(srcdir)/%.c $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp)
        $(AM_V_GEN)$(REGEN_TEXI)
+%D%/%.stamp: $(srcdir)/%.h $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp)
+       $(AM_V_GEN)$(REGEN_TEXI)
 
 # Avoid the %.stamp generating a builddir/bfd.texi that overrides the
 # srcdir/ as well as regenerating doc/bfd.info for each make run.

diff --git a/bfd/libbfd.c b/bfd/libbfd.c
index fafdf49cb0457d0d129031f8c2135f7dae1eacb4..3c37717f7756ced552745fe94f89d0f6e1c77441 100644 (file)
--- a/bfd/libbfd.c
+++ b/bfd/libbfd.c
@@ -728,6 +728,13 @@ SYNOPSIS
        void bfd_putl16 (bfd_vma, void *);
        uint64_t bfd_get_bits (const void *, int, bool);
        void bfd_put_bits (uint64_t, void *, int, bool);
+
+DESCRIPTION
+       Read and write integers in a particular endian order.  getb
+       and putb functions handle big-endian, getl and putl handle
+       little-endian.  bfd_get_bits and bfd_put_bits specify
+       big-endian by passing TRUE in the last parameter,
+       little-endian by passing FALSE.
 */
 
 bfd_vma