From 17ecba1a84dcd53566124c78d7378f044820d8cb Mon Sep 17 00:00:00 2001 From: David MacKenzie Date: Sat, 6 Nov 1993 04:10:25 +0000 Subject: [PATCH] more doc cleanups --- bfd/core.c | 2 +- bfd/libbfd.c | 26 +++++++++++++------------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/bfd/core.c b/bfd/core.c index 4fd837dee2c..bcdb9a4de48 100644 --- a/bfd/core.c +++ b/bfd/core.c @@ -90,7 +90,7 @@ SYNOPSIS DESCRIPTION Return <> if the core file attached to @var{core_bfd} was generated by a run of the executable file attached to - @var{exec_bfd}, or else <>. + @var{exec_bfd}, <> otherwise. */ boolean core_file_matches_executable_p (core_bfd, exec_bfd) diff --git a/bfd/libbfd.c b/bfd/libbfd.c index 90e100dcdd1..74a28afdb20 100644 --- a/bfd/libbfd.c +++ b/bfd/libbfd.c @@ -24,7 +24,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ /* SECTION - libbfd + Internal functions DESCRIPTION These routines are used within BFD. @@ -135,7 +135,7 @@ INTERNAL_FUNCTION bfd_xmalloc SYNOPSIS - PTR bfd_xmalloc( bfd_size_type size); + PTR bfd_xmalloc (bfd_size_type size); DESCRIPTION Like <>, but exit if no more memory. @@ -167,7 +167,7 @@ INTERNAL_FUNCTION bfd_xmalloc_by_size_t SYNOPSIS - PTR bfd_xmalloc_by_size_t ( size_t size); + PTR bfd_xmalloc_by_size_t (size_t size); DESCRIPTION Like <>, but exit if no more memory. @@ -446,16 +446,16 @@ DESCRIPTION mangling performs any necessary endian translations and removes alignment restrictions. Note that types accepted and returned by these macros are identical so they can be swapped - around in macros--for example libaout.h defines GET_WORD to - either bfd_get_32 or bfd_get_64. + around in macros---for example, @file{libaout.h} defines <> + to either <> or <>. - In the put routines, val must be a bfd_vma. If we are on a + In the put routines, @var{val} must be a <>. If we are on a system without prototypes, the caller is responsible for making sure that is true, with a cast if necessary. We don't cast - them in the macro definitions because that would prevent lint - or gcc -Wall from detecting sins such as passing a pointer. - To detect calling these with less than a bfd_vma, use gcc - -Wconversion on a host with 64 bit bfd_vma's. + them in the macro definitions because that would prevent <> + or <> from detecting sins such as passing a pointer. + To detect calling these with less than a <>, use + <> on a host with 64 bit <>'s. . .{* Byte swapping macros for user section data. *} @@ -848,12 +848,12 @@ bfd_generic_set_section_contents (abfd, section, location, offset, count) INTERNAL_FUNCTION bfd_log2 +SYNOPSIS + unsigned int bfd_log2(bfd_vma x); + DESCRIPTION Return the log base 2 of the value supplied, rounded up. E.g., an @var{x} of 1025 returns 11. - -SYNOPSIS - unsigned int bfd_log2(bfd_vma x); */ unsigned -- 2.30.2