merge from gcc

diff --git a/libiberty/ChangeLog b/libiberty/ChangeLog
index 3896830ba0e22a5d57cc4656d43b3736a102a9d3..7fba7cbc7763e356f970a3e7d511181c87a2cd67 100644 (file)
--- a/libiberty/ChangeLog
+++ b/libiberty/ChangeLog
@@ -1,3 +1,13 @@
+2001-10-07  Joseph S. Myers  <jsm28@cam.ac.uk>
+
+       * alloca.c, clock.c, getcwd.c, getpagesize.c, getpwd.c, index.c,
+       libiberty.texi, memchr.c, putenv.c, rindex.c, strchr.c, strdup.c,
+       strerror.c, strrchr.c, strstr.c, strtod.c, tmpnam.c, vfork.c,
+       xatexit.c, xmalloc.c, xstrerror.c: Improve manual formatting.  Fix
+       spelling.  Give names to function arguments in documentation.  Use
+       (void) prototypes in documentation.
+       * functions.texi: Regenerate.
+

 2001-10-07  Kaveh R. Ghazi  <ghazi@caip.rutgers.edu>
 
        * argv.c (buildargv, tests, main): Const-ify.
 2001-10-07  Kaveh R. Ghazi  <ghazi@caip.rutgers.edu>
 
        * argv.c (buildargv, tests, main): Const-ify.

diff --git a/libiberty/alloca.c b/libiberty/alloca.c
index 9c07e0d481c22f9fff7cc9a23ab58ff4b0eb5e9e..e98a053fbee5651f91af963b87d5109a90c749bd 100644 (file)
--- a/libiberty/alloca.c
+++ b/libiberty/alloca.c
@@ -23,7 +23,7 @@
 
 /*
 
 
 /*
 

-@deftypefn Replacement void* alloca (size_t)
+@deftypefn Replacement void* alloca (size_t @var{size})

 
 This function allocates memory which will be automatically reclaimed
 after the procedure exits.  The @libib{} implementation does not free
 
 This function allocates memory which will be automatically reclaimed
 after the procedure exits.  The @libib{} implementation does not free


@@ -36,7 +36,7 @@ GNU Autoconf test @code{AC_FUNC_ALLOCA} to test for and properly make
 available this function.  The @code{AC_FUNC_ALLOCA} test requires that
 client code use a block of preprocessor code to be safe (see the Autoconf
 manual for more); this header incorporates that logic and more, including
 available this function.  The @code{AC_FUNC_ALLOCA} test requires that
 client code use a block of preprocessor code to be safe (see the Autoconf
 manual for more); this header incorporates that logic and more, including

-the possibility of a GCC builtin function.
+the possibility of a GCC built-in function.

 
 @end deftypefn
 
 
 @end deftypefn
 

diff --git a/libiberty/clock.c b/libiberty/clock.c
index 187af7049c21b1e25cb4d9e74898992606bfb094..3ea70c31c603a10851fde24b6bd0968ec5b932e6 100644 (file)
--- a/libiberty/clock.c
+++ b/libiberty/clock.c
@@ -24,7 +24,7 @@ the executable file might be covered by the GNU General Public License. */
 
 /*
 
 
 /*
 

-@deftypefn Supplemental long clock ()
+@deftypefn Supplemental long clock (void)

 
 Returns an approximation of the CPU time used by the process as a
 @code{clock_t}; divide this number by @samp{CLOCKS_PER_SEC} to get the
 
 Returns an approximation of the CPU time used by the process as a
 @code{clock_t}; divide this number by @samp{CLOCKS_PER_SEC} to get the

diff --git a/libiberty/functions.texi b/libiberty/functions.texi
index c00d047dfa8054b3b047315b530a1add2f9a525a..4ce7e9caa9d169a6be96554363fafc5f6959825f 100644 (file)
--- a/libiberty/functions.texi
+++ b/libiberty/functions.texi
@@ -4,7 +4,7 @@
 @c and let gather-docs build you a new copy.
 
 @c alloca.c:26
 @c and let gather-docs build you a new copy.
 
 @c alloca.c:26

-@deftypefn Replacement void* alloca (size_t)
+@deftypefn Replacement void* alloca (size_t @var{size})

 
 This function allocates memory which will be automatically reclaimed
 after the procedure exits.  The @libib{} implementation does not free
 
 This function allocates memory which will be automatically reclaimed
 after the procedure exits.  The @libib{} implementation does not free


@@ -17,7 +17,7 @@ GNU Autoconf test @code{AC_FUNC_ALLOCA} to test for and properly make
 available this function.  The @code{AC_FUNC_ALLOCA} test requires that
 client code use a block of preprocessor code to be safe (see the Autoconf
 manual for more); this header incorporates that logic and more, including
 available this function.  The @code{AC_FUNC_ALLOCA} test requires that
 client code use a block of preprocessor code to be safe (see the Autoconf
 manual for more); this header incorporates that logic and more, including

-the possibility of a GCC builtin function.
+the possibility of a GCC built-in function.

 
 @end deftypefn
 
 
 @end deftypefn
 


@@ -86,7 +86,7 @@ Uses @code{malloc} to allocate storage for @var{nelem} objects of
 @end deftypefn
 
 @c clock.c:27
 @end deftypefn
 
 @c clock.c:27

-@deftypefn Supplemental long clock ()
+@deftypefn Supplemental long clock (void)

 
 Returns an approximation of the CPU time used by the process as a
 @code{clock_t}; divide this number by @samp{CLOCKS_PER_SEC} to get the
 
 Returns an approximation of the CPU time used by the process as a
 @code{clock_t}; divide this number by @samp{CLOCKS_PER_SEC} to get the


@@ -105,7 +105,7 @@ fact, the manual page for @code{perror(3C)} explicitly warns that one
 should check the size of the table (@code{sys_nerr}) before indexing
 it, since new error codes may be added to the system before they are
 added to the table.  Thus @code{sys_nerr} might be smaller than value
 should check the size of the table (@code{sys_nerr}) before indexing
 it, since new error codes may be added to the system before they are
 added to the table.  Thus @code{sys_nerr} might be smaller than value

-implied by the largest @code{errno} value defined in @file{errno.h}.
+implied by the largest @code{errno} value defined in @code{<errno.h>}.

 
 We return the maximum value that can be used to obtain a meaningful
 symbolic name or message.
 
 We return the maximum value that can be used to obtain a meaningful
 symbolic name or message.


@@ -113,20 +113,20 @@ symbolic name or message.
 @end deftypefn
 
 @c getcwd.c:6
 @end deftypefn
 
 @c getcwd.c:6

-@deftypefn Supplemental char* getcwd (char *@var{pathname}, @var{len})
+@deftypefn Supplemental char* getcwd (char *@var{pathname}, int @var{len})

 
 Copy the absolute pathname for the current working directory into
 @var{pathname}, which is assumed to point to a buffer of at least
 @var{len} bytes, and return a pointer to the buffer.  If the current
 directory's path doesn't fit in @var{len} characters, the result is
 
 Copy the absolute pathname for the current working directory into
 @var{pathname}, which is assumed to point to a buffer of at least
 @var{len} bytes, and return a pointer to the buffer.  If the current
 directory's path doesn't fit in @var{len} characters, the result is

-NULL and @var{errno} is set.  If @var{pathname} is a null pointer,
+@code{NULL} and @code{errno} is set.  If @var{pathname} is a null pointer,

 @code{getcwd} will obtain @var{len} bytes of space using
 @code{malloc}.
 
 @end deftypefn
 
 @c getpagesize.c:5
 @code{getcwd} will obtain @var{len} bytes of space using
 @code{malloc}.
 
 @end deftypefn
 
 @c getpagesize.c:5

-@deftypefn Supplemental int getpagesize ()
+@deftypefn Supplemental int getpagesize (void)

 
 Returns the number of bytes in a page of memory.  This is the
 granularity of many of the system memory management routines.  No
 
 Returns the number of bytes in a page of memory.  This is the
 granularity of many of the system memory management routines.  No


@@ -136,7 +136,7 @@ memory management hardware page size.
 @end deftypefn
 
 @c getpwd.c:5
 @end deftypefn
 
 @c getpwd.c:5

-@deftypefn Supplemental char* getpwd ()
+@deftypefn Supplemental char* getpwd (void)

 
 Returns the current working directory.  This implementation caches the
 result on the assumption that the process will not call @code{chdir}
 
 Returns the current working directory.  This implementation caches the
 result on the assumption that the process will not call @code{chdir}


@@ -148,7 +148,7 @@ between calls to @code{getpwd}.
 @deftypefn Supplemental char* index (char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in
 @deftypefn Supplemental char* index (char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  The use of @code{index} is
+the string @var{s}, or @code{NULL} if not found.  The use of @code{index} is

 deprecated in new programs in favor of @code{strchr}.
 
 @end deftypefn
 deprecated in new programs in favor of @code{strchr}.
 
 @end deftypefn


@@ -156,12 +156,12 @@ deprecated in new programs in favor of @code{strchr}.
 @c memchr.c:3
 @deftypefn Supplemental void* memchr (const void *@var{s}, int @var{c}, size_t @var{n})
 
 @c memchr.c:3
 @deftypefn Supplemental void* memchr (const void *@var{s}, int @var{c}, size_t @var{n})
 

-This function searches memory starting at @code{*}@var{src} for the
+This function searches memory starting at @code{*@var{s}} for the

 character @var{c}.  The search only ends with the first occurrence of
 @var{c}, or after @var{length} characters; in particular, a null
 character does not terminate the search.  If the character @var{c} is
 character @var{c}.  The search only ends with the first occurrence of
 @var{c}, or after @var{length} characters; in particular, a null
 character does not terminate the search.  If the character @var{c} is

-found within @var{length} characters of @code{*}@var{src}, a pointer
-to the character is returned. If @var{c} is not found, then NULL is
+found within @var{length} characters of @code{*@var{s}}, a pointer
+to the character is returned.  If @var{c} is not found, then @code{NULL} is

 returned.
 
 @end deftypefn
 returned.
 
 @end deftypefn


@@ -206,7 +206,7 @@ Sets the first @var{count} bytes of @var{s} to the constant byte
 
 Uses @code{setenv} or @code{unsetenv} to put @var{string} into
 the environment or remove it.  If @var{string} is of the form
 
 Uses @code{setenv} or @code{unsetenv} to put @var{string} into
 the environment or remove it.  If @var{string} is of the form

-@samp{name=value} the string is added; if no `=' is present the
+@samp{name=value} the string is added; if no @samp{=} is present the

 name is unset/removed.
 
 @end deftypefn
 name is unset/removed.
 
 @end deftypefn


@@ -223,7 +223,7 @@ exists, it is removed.
 @deftypefn Supplemental char* rindex (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in
 @deftypefn Supplemental char* rindex (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  The use of @code{rindex} is
+the string @var{s}, or @code{NULL} if not found.  The use of @code{rindex} is

 deprecated in new programs in favor of @code{strrchr}.
 
 @end deftypefn
 deprecated in new programs in favor of @code{strrchr}.
 
 @end deftypefn


@@ -260,7 +260,7 @@ A case-insensitive @code{strcmp}.
 @deftypefn Supplemental char* strchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in
 @deftypefn Supplemental char* strchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  If @var{c} is itself the
+the string @var{s}, or @code{NULL} if not found.  If @var{c} is itself the

 null character, the results are undefined.
 
 @end deftypefn
 null character, the results are undefined.
 
 @end deftypefn


@@ -269,7 +269,7 @@ null character, the results are undefined.
 @deftypefn Supplemental char* strdup (const char *@var{s})
 
 Returns a pointer to a copy of @var{s} in memory obtained from
 @deftypefn Supplemental char* strdup (const char *@var{s})
 
 Returns a pointer to a copy of @var{s} in memory obtained from

-@code{malloc}, or NULL if insufficient memory was available.
+@code{malloc}, or @code{NULL} if insufficient memory was available.

 
 @end deftypefn
 
 
 @end deftypefn
 


@@ -278,7 +278,7 @@ Returns a pointer to a copy of @var{s} in memory obtained from
 
 Given an error number returned from a system call (typically returned
 in @code{errno}), returns a pointer to a string containing the
 
 Given an error number returned from a system call (typically returned
 in @code{errno}), returns a pointer to a string containing the

-symbolic name of that error number, as found in @file{errno.h}.
+symbolic name of that error number, as found in @code{<errno.h>}.

 
 If the supplied error number is within the valid range of indices for
 symbolic names, but no name is available for the particular error
 
 If the supplied error number is within the valid range of indices for
 symbolic names, but no name is available for the particular error


@@ -286,7 +286,7 @@ number, then returns the string @samp{"Error @var{num}"}, where @var{num}
 is the error number.
 
 If the supplied error number is not within the range of valid
 is the error number.
 
 If the supplied error number is not within the range of valid

-indices, then returns NULL.
+indices, then returns @code{NULL}.

 
 The contents of the location pointed to are only guaranteed to be
 valid until the next call to @code{strerrno}.
 
 The contents of the location pointed to are only guaranteed to be
 valid until the next call to @code{strerrno}.


@@ -307,7 +307,7 @@ error number, then returns the string @samp{"Error @var{num}"}, where
 @var{num} is the error number.
 
 If the supplied error number is not a valid index into
 @var{num} is the error number.
 
 If the supplied error number is not a valid index into

-@code{sys_errlist}, returns NULL.
+@code{sys_errlist}, returns @code{NULL}.

 
 The returned string is only guaranteed to be valid only until the
 next call to @code{strerror}.
 
 The returned string is only guaranteed to be valid only until the
 next call to @code{strerror}.


@@ -333,7 +333,7 @@ Compares the first @var{n} bytes of two strings, returning a value as
 @deftypefn Supplemental char* strrchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in
 @deftypefn Supplemental char* strrchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  If @var{c} is itself the
+the string @var{s}, or @code{NULL} if not found.  If @var{c} is itself the

 null character, the results are undefined.
 
 @end deftypefn
 null character, the results are undefined.
 
 @end deftypefn


@@ -343,7 +343,7 @@ null character, the results are undefined.
 
 This function searches for the substring @var{sub} in the string
 @var{string}, not including the terminating null characters.  A pointer
 
 This function searches for the substring @var{sub} in the string
 @var{string}, not including the terminating null characters.  A pointer

-to the first occurrence of @var{sub} is returned, or NULL if the
+to the first occurrence of @var{sub} is returned, or @code{NULL} if the

 substring is absent.  If @var{sub} points to a string with zero
 length, the function returns @var{string}.
 
 substring is absent.  If @var{sub} points to a string with zero
 length, the function returns @var{string}.
 


@@ -353,7 +353,7 @@ length, the function returns @var{string}.
 @deftypefn Supplemental double strtod (const char *@var{string}, char **@var{endptr})
 
 This ANSI C function converts the initial portion of @var{string} to a
 @deftypefn Supplemental double strtod (const char *@var{string}, char **@var{endptr})
 
 This ANSI C function converts the initial portion of @var{string} to a

-@code{double}.  If @var{endptr} is not NULL, a pointer to the
+@code{double}.  If @var{endptr} is not @code{NULL}, a pointer to the

 character after the last character used in the conversion is stored in
 the location referenced by @var{endptr}.  If no conversion is
 performed, zero is returned and the value of @var{string} is stored in
 character after the last character used in the conversion is stored in
 the location referenced by @var{endptr}.  If no conversion is
 performed, zero is returned and the value of @var{string} is stored in


@@ -364,7 +364,7 @@ the location referenced by @var{endptr}.
 @c strerror.c:730
 @deftypefn Replacement int strtoerrno (const char *@var{name})
 
 @c strerror.c:730
 @deftypefn Replacement int strtoerrno (const char *@var{name})
 

-Given the symbolic name of a error number (e.g., @code{EACCESS}), map it
+Given the symbolic name of a error number (e.g., @code{EACCES}), map it

 to an errno value.  If no translation is found, returns 0.
 
 @end deftypefn
 to an errno value.  If no translation is found, returns 0.
 
 @end deftypefn


@@ -389,13 +389,13 @@ When the base is 16 (either explicitly or implicitly), a prefix of
 This function attempts to create a name for a temporary file, which
 will be a valid file name yet not exist when @code{tmpnam} checks for
 it.  @var{s} must point to a buffer of at least @code{L_tmpnam} bytes,
 This function attempts to create a name for a temporary file, which
 will be a valid file name yet not exist when @code{tmpnam} checks for
 it.  @var{s} must point to a buffer of at least @code{L_tmpnam} bytes,

-or be NULL.  Use of this function creates a security risk, and it must
+or be @code{NULL}.  Use of this function creates a security risk, and it must

 not be used in new projects.  Use @code{mkstemp} instead.
 
 @end deftypefn
 
 @c vfork.c:6
 not be used in new projects.  Use @code{mkstemp} instead.
 
 @end deftypefn
 
 @c vfork.c:6

-@deftypefn Supplemental int vfork ()
+@deftypefn Supplemental int vfork (void)

 
 Emulates @code{vfork} by calling @code{fork} and returning its value.
 
 
 Emulates @code{vfork} by calling @code{fork} and returning its value.
 


@@ -428,14 +428,14 @@ does the return value.  The third argument is unused in @libib{}.
 @deftypefun int xatexit (void (*@var{fn}) (void))
 
 Behaves as the standard @code{atexit} function, but with no limit on
 @deftypefun int xatexit (void (*@var{fn}) (void))
 
 Behaves as the standard @code{atexit} function, but with no limit on

-the number of registered functions.  Returns 0 on success, or -1 on
+the number of registered functions.  Returns 0 on success, or @minus{}1 on

 failure.  If you use @code{xatexit} to register functions, you must use
 @code{xexit} to terminate your program.
 
 @end deftypefun
 
 @c xmalloc.c:38
 failure.  If you use @code{xatexit} to register functions, you must use
 @code{xexit} to terminate your program.
 
 @end deftypefun
 
 @c xmalloc.c:38

-@deftypefn Replacement void* xcalloc (size_t, size_t)
+@deftypefn Replacement void* xcalloc (size_t @var{nelem}, size_t @var{elsize})

 
 Allocate memory without fail, and set it to zero.  This routine functions
 like @code{calloc}, but will behave the same as @code{xmalloc} if memory
 
 Allocate memory without fail, and set it to zero.  This routine functions
 like @code{calloc}, but will behave the same as @code{xmalloc} if memory


@@ -491,7 +491,7 @@ allocated, the remaining memory is zeroed.
 @end deftypefn
 
 @c xmalloc.c:32
 @end deftypefn
 
 @c xmalloc.c:32

-@deftypefn Replacement void* xrealloc (void*, size_t)
+@deftypefn Replacement void* xrealloc (void *@var{ptr}, size_t @var{size})

 Reallocate memory without fail.  This routine functions like @code{realloc},
 but will behave the same as @code{xmalloc} if memory cannot be found.
 
 Reallocate memory without fail.  This routine functions like @code{realloc},
 but will behave the same as @code{xmalloc} if memory cannot be found.
 


@@ -509,7 +509,7 @@ obtain memory.
 @deftypefn Replacement char* xstrerror (int @var{errnum})
 
 Behaves exactly like the standard @code{strerror} function, but
 @deftypefn Replacement char* xstrerror (int @var{errnum})
 
 Behaves exactly like the standard @code{strerror} function, but

-will never return a NULL pointer.
+will never return a @code{NULL} pointer.

 
 @end deftypefn
 
 
 @end deftypefn
 

diff --git a/libiberty/getcwd.c b/libiberty/getcwd.c
index 8c7c04ceb4e873c242f4bea171faf36d45041c03..465b4e0b2aa430ff80b48f6a2ce57e1d416f9cba 100644 (file)
--- a/libiberty/getcwd.c
+++ b/libiberty/getcwd.c
@@ -3,13 +3,13 @@
 
 /*
 
 
 /*
 

-@deftypefn Supplemental char* getcwd (char *@var{pathname}, @var{len})
+@deftypefn Supplemental char* getcwd (char *@var{pathname}, int @var{len})

 
 Copy the absolute pathname for the current working directory into
 @var{pathname}, which is assumed to point to a buffer of at least
 @var{len} bytes, and return a pointer to the buffer.  If the current
 directory's path doesn't fit in @var{len} characters, the result is
 
 Copy the absolute pathname for the current working directory into
 @var{pathname}, which is assumed to point to a buffer of at least
 @var{len} bytes, and return a pointer to the buffer.  If the current
 directory's path doesn't fit in @var{len} characters, the result is

-NULL and @var{errno} is set.  If @var{pathname} is a null pointer,
+@code{NULL} and @code{errno} is set.  If @var{pathname} is a null pointer,

 @code{getcwd} will obtain @var{len} bytes of space using
 @code{malloc}.
 
 @code{getcwd} will obtain @var{len} bytes of space using
 @code{malloc}.
 

diff --git a/libiberty/getpagesize.c b/libiberty/getpagesize.c
index 05b8110ad3ca6576a5652556a6c32f0ad50912bc..eed9680378a7813a2f94c1877f8d1af12ede4352 100644 (file)
--- a/libiberty/getpagesize.c
+++ b/libiberty/getpagesize.c
@@ -2,7 +2,7 @@
 
 /*
 
 
 /*
 

-@deftypefn Supplemental int getpagesize ()
+@deftypefn Supplemental int getpagesize (void)

 
 Returns the number of bytes in a page of memory.  This is the
 granularity of many of the system memory management routines.  No
 
 Returns the number of bytes in a page of memory.  This is the
 granularity of many of the system memory management routines.  No

diff --git a/libiberty/getpwd.c b/libiberty/getpwd.c
index c5408794a2764983612d889da11dc65593d51041..f508b1e21e520a2e4343d5a53241e860a6056932 100644 (file)
--- a/libiberty/getpwd.c
+++ b/libiberty/getpwd.c
@@ -2,7 +2,7 @@
 
 /*
 
 
 /*
 

-@deftypefn Supplemental char* getpwd ()
+@deftypefn Supplemental char* getpwd (void)

 
 Returns the current working directory.  This implementation caches the
 result on the assumption that the process will not call @code{chdir}
 
 Returns the current working directory.  This implementation caches the
 result on the assumption that the process will not call @code{chdir}

diff --git a/libiberty/index.c b/libiberty/index.c
index 55a4acc17c2fa63a83672f6486414213bfb5afe5..a2e272783b908824d6903fd8ddaf9ecdb90d2c5e 100644 (file)
--- a/libiberty/index.c
+++ b/libiberty/index.c
@@ -5,7 +5,7 @@
 @deftypefn Supplemental char* index (char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in
 @deftypefn Supplemental char* index (char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  The use of @code{index} is
+the string @var{s}, or @code{NULL} if not found.  The use of @code{index} is

 deprecated in new programs in favor of @code{strchr}.
 
 @end deftypefn
 deprecated in new programs in favor of @code{strchr}.
 
 @end deftypefn

diff --git a/libiberty/libiberty.texi b/libiberty/libiberty.texi
index a13bf2c4e1723fd017a4793bb457060d29875532..4b60d6a07fb9d10f77d13e73450cc2ef57653581 100644 (file)
--- a/libiberty/libiberty.texi
+++ b/libiberty/libiberty.texi
@@ -65,7 +65,8 @@ Copyright @copyright{} 2001 Free Software Foundation, Inc.
       section entitled ``GNU Free Documentation License''.
 
 @end titlepage
       section entitled ``GNU Free Documentation License''.
 
 @end titlepage

-
+@contents
+@page

 
 @ifnottex
 @node    Top,Using,,
 
 @ifnottex
 @node    Top,Using,,


@@ -319,6 +320,5 @@ SUCH DAMAGE.
 
 @printindex cp
 
 
 @printindex cp
 

-@contents

 @bye
 
 @bye
 

diff --git a/libiberty/memchr.c b/libiberty/memchr.c
index f053be71dc593c8ff3257e766af06c667cb2c8dd..f94bea018f53e351bebcccb8f8e80331426d6672 100644 (file)
--- a/libiberty/memchr.c
+++ b/libiberty/memchr.c
@@ -2,12 +2,12 @@
 
 @deftypefn Supplemental void* memchr (const void *@var{s}, int @var{c}, size_t @var{n})
 
 
 @deftypefn Supplemental void* memchr (const void *@var{s}, int @var{c}, size_t @var{n})
 

-This function searches memory starting at @code{*}@var{src} for the
+This function searches memory starting at @code{*@var{s}} for the

 character @var{c}.  The search only ends with the first occurrence of
 @var{c}, or after @var{length} characters; in particular, a null
 character does not terminate the search.  If the character @var{c} is
 character @var{c}.  The search only ends with the first occurrence of
 @var{c}, or after @var{length} characters; in particular, a null
 character does not terminate the search.  If the character @var{c} is

-found within @var{length} characters of @code{*}@var{src}, a pointer
-to the character is returned. If @var{c} is not found, then NULL is
+found within @var{length} characters of @code{*@var{s}}, a pointer
+to the character is returned.  If @var{c} is not found, then @code{NULL} is

 returned.
 
 @end deftypefn
 returned.
 
 @end deftypefn

diff --git a/libiberty/putenv.c b/libiberty/putenv.c
index a655b59f8e354129a2d50742a2e83bd31cb0f693..58012fc83ad27828f692fcb280e8b7afa9b0b4c2 100644 (file)
--- a/libiberty/putenv.c
+++ b/libiberty/putenv.c
@@ -22,7 +22,7 @@
 
 Uses @code{setenv} or @code{unsetenv} to put @var{string} into
 the environment or remove it.  If @var{string} is of the form
 
 Uses @code{setenv} or @code{unsetenv} to put @var{string} into
 the environment or remove it.  If @var{string} is of the form

-@samp{name=value} the string is added; if no `=' is present the
+@samp{name=value} the string is added; if no @samp{=} is present the

 name is unset/removed.
 
 @end deftypefn
 name is unset/removed.
 
 @end deftypefn

diff --git a/libiberty/rindex.c b/libiberty/rindex.c
index 9c25dff4dcc4579b99b29543c5e1835cab9fd29f..ef9cdc59877dc1a83ce479786c88ca913579dfaa 100644 (file)
--- a/libiberty/rindex.c
+++ b/libiberty/rindex.c
@@ -5,7 +5,7 @@
 @deftypefn Supplemental char* rindex (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in
 @deftypefn Supplemental char* rindex (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  The use of @code{rindex} is
+the string @var{s}, or @code{NULL} if not found.  The use of @code{rindex} is

 deprecated in new programs in favor of @code{strrchr}.
 
 @end deftypefn
 deprecated in new programs in favor of @code{strrchr}.
 
 @end deftypefn

diff --git a/libiberty/strchr.c b/libiberty/strchr.c
index 6f327f2a2418976e17ebbf8eb19caa483583b90f..1f71c5143d08814b675d80e01a886e6741a4276c 100644 (file)
--- a/libiberty/strchr.c
+++ b/libiberty/strchr.c
@@ -6,7 +6,7 @@
 @deftypefn Supplemental char* strchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in
 @deftypefn Supplemental char* strchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the first occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  If @var{c} is itself the
+the string @var{s}, or @code{NULL} if not found.  If @var{c} is itself the

 null character, the results are undefined.
 
 @end deftypefn
 null character, the results are undefined.
 
 @end deftypefn

diff --git a/libiberty/strdup.c b/libiberty/strdup.c
index a01cedfbee03359de1dda64646283dba5f7f0acc..49233ba7aac99603030a43264b5e7ea8b08149d3 100644 (file)
--- a/libiberty/strdup.c
+++ b/libiberty/strdup.c
@@ -3,7 +3,7 @@
 @deftypefn Supplemental char* strdup (const char *@var{s})
 
 Returns a pointer to a copy of @var{s} in memory obtained from
 @deftypefn Supplemental char* strdup (const char *@var{s})
 
 Returns a pointer to a copy of @var{s} in memory obtained from

-@code{malloc}, or NULL if insufficient memory was available.
+@code{malloc}, or @code{NULL} if insufficient memory was available.

 
 @end deftypefn
 
 
 @end deftypefn
 

diff --git a/libiberty/strerror.c b/libiberty/strerror.c
index 046ffe6a1b74870851e467f85d450d969f9103dd..37fbf4d0a8bc7aea20c48d59c976f3408a24d06e 100644 (file)
--- a/libiberty/strerror.c
+++ b/libiberty/strerror.c
@@ -573,7 +573,7 @@ fact, the manual page for @code{perror(3C)} explicitly warns that one
 should check the size of the table (@code{sys_nerr}) before indexing
 it, since new error codes may be added to the system before they are
 added to the table.  Thus @code{sys_nerr} might be smaller than value
 should check the size of the table (@code{sys_nerr}) before indexing
 it, since new error codes may be added to the system before they are
 added to the table.  Thus @code{sys_nerr} might be smaller than value

-implied by the largest @code{errno} value defined in @file{errno.h}.
+implied by the largest @code{errno} value defined in @code{<errno.h>}.

 
 We return the maximum value that can be used to obtain a meaningful
 symbolic name or message.
 
 We return the maximum value that can be used to obtain a meaningful
 symbolic name or message.


@@ -612,7 +612,7 @@ error number, then returns the string @samp{"Error @var{num}"}, where
 @var{num} is the error number.
 
 If the supplied error number is not a valid index into
 @var{num} is the error number.
 
 If the supplied error number is not a valid index into

-@code{sys_errlist}, returns NULL.
+@code{sys_errlist}, returns @code{NULL}.

 
 The returned string is only guaranteed to be valid only until the
 next call to @code{strerror}.
 
 The returned string is only guaranteed to be valid only until the
 next call to @code{strerror}.


@@ -671,7 +671,7 @@ strerror (errnoval)
 
 Given an error number returned from a system call (typically returned
 in @code{errno}), returns a pointer to a string containing the
 
 Given an error number returned from a system call (typically returned
 in @code{errno}), returns a pointer to a string containing the

-symbolic name of that error number, as found in @file{errno.h}.
+symbolic name of that error number, as found in @code{<errno.h>}.

 
 If the supplied error number is within the valid range of indices for
 symbolic names, but no name is available for the particular error
 
 If the supplied error number is within the valid range of indices for
 symbolic names, but no name is available for the particular error


@@ -679,7 +679,7 @@ number, then returns the string @samp{"Error @var{num}"}, where @var{num}
 is the error number.
 
 If the supplied error number is not within the range of valid
 is the error number.
 
 If the supplied error number is not within the range of valid

-indices, then returns NULL.
+indices, then returns @code{NULL}.

 
 The contents of the location pointed to are only guaranteed to be
 valid until the next call to @code{strerrno}.
 
 The contents of the location pointed to are only guaranteed to be
 valid until the next call to @code{strerrno}.


@@ -729,7 +729,7 @@ strerrno (errnoval)
 
 @deftypefn Replacement int strtoerrno (const char *@var{name})
 
 
 @deftypefn Replacement int strtoerrno (const char *@var{name})
 

-Given the symbolic name of a error number (e.g., @code{EACCESS}), map it
+Given the symbolic name of a error number (e.g., @code{EACCES}), map it

 to an errno value.  If no translation is found, returns 0.
 
 @end deftypefn
 to an errno value.  If no translation is found, returns 0.
 
 @end deftypefn

diff --git a/libiberty/strrchr.c b/libiberty/strrchr.c
index 9dc31f2a1597c8d4bead8d4e3979a8650173b24e..bc380c4c5d30946700c33fea0563381f23fe3cdd 100644 (file)
--- a/libiberty/strrchr.c
+++ b/libiberty/strrchr.c
@@ -6,7 +6,7 @@
 @deftypefn Supplemental char* strrchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in
 @deftypefn Supplemental char* strrchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in

-the string @var{s}, or NULL if not found.  If @var{c} is itself the
+the string @var{s}, or @code{NULL} if not found.  If @var{c} is itself the

 null character, the results are undefined.
 
 @end deftypefn
 null character, the results are undefined.
 
 @end deftypefn

diff --git a/libiberty/strstr.c b/libiberty/strstr.c
index ffe1d10fc9ef5f6e241cc7b8be1344943ef88a33..470e04b1a7613c0e848aa39d6775a2a34912cf44 100644 (file)
--- a/libiberty/strstr.c
+++ b/libiberty/strstr.c
@@ -7,7 +7,7 @@
 
 This function searches for the substring @var{sub} in the string
 @var{string}, not including the terminating null characters.  A pointer
 
 This function searches for the substring @var{sub} in the string
 @var{string}, not including the terminating null characters.  A pointer

-to the first occurrence of @var{sub} is returned, or NULL if the
+to the first occurrence of @var{sub} is returned, or @code{NULL} if the

 substring is absent.  If @var{sub} points to a string with zero
 length, the function returns @var{string}.
 
 substring is absent.  If @var{sub} points to a string with zero
 length, the function returns @var{string}.
 

diff --git a/libiberty/strtod.c b/libiberty/strtod.c
index 2f0a0762fc36b45a0cce1f8cb5629c7b154f82a7..874e5e5241626dc3819a1c84fefac50c8dbe7bea 100644 (file)
--- a/libiberty/strtod.c
+++ b/libiberty/strtod.c
@@ -27,7 +27,7 @@ the executable file might be covered by the GNU General Public License. */
 @deftypefn Supplemental double strtod (const char *@var{string}, char **@var{endptr})
 
 This ANSI C function converts the initial portion of @var{string} to a
 @deftypefn Supplemental double strtod (const char *@var{string}, char **@var{endptr})
 
 This ANSI C function converts the initial portion of @var{string} to a

-@code{double}.  If @var{endptr} is not NULL, a pointer to the
+@code{double}.  If @var{endptr} is not @code{NULL}, a pointer to the

 character after the last character used in the conversion is stored in
 the location referenced by @var{endptr}.  If no conversion is
 performed, zero is returned and the value of @var{string} is stored in
 character after the last character used in the conversion is stored in
 the location referenced by @var{endptr}.  If no conversion is
 performed, zero is returned and the value of @var{string} is stored in

diff --git a/libiberty/tmpnam.c b/libiberty/tmpnam.c
index 99615df7fe5d7454db7a542a725dd7cdff247787..406878c49a3eadcac4772f55a4c7bb4bffcbef53 100644 (file)
--- a/libiberty/tmpnam.c
+++ b/libiberty/tmpnam.c
@@ -5,7 +5,7 @@
 This function attempts to create a name for a temporary file, which
 will be a valid file name yet not exist when @code{tmpnam} checks for
 it.  @var{s} must point to a buffer of at least @code{L_tmpnam} bytes,
 This function attempts to create a name for a temporary file, which
 will be a valid file name yet not exist when @code{tmpnam} checks for
 it.  @var{s} must point to a buffer of at least @code{L_tmpnam} bytes,

-or be NULL.  Use of this function creates a security risk, and it must
+or be @code{NULL}.  Use of this function creates a security risk, and it must

 not be used in new projects.  Use @code{mkstemp} instead.
 
 @end deftypefn
 not be used in new projects.  Use @code{mkstemp} instead.
 
 @end deftypefn

diff --git a/libiberty/vfork.c b/libiberty/vfork.c
index 7df7a22626066bee874fee80ef350a882c6a0719..4aa5c21d42714793fab1de8a42180f66a7f03af9 100644 (file)
--- a/libiberty/vfork.c
+++ b/libiberty/vfork.c
@@ -3,7 +3,7 @@
 
 /*
 
 
 /*
 

-@deftypefn Supplemental int vfork ()
+@deftypefn Supplemental int vfork (void)

 
 Emulates @code{vfork} by calling @code{fork} and returning its value.
 
 
 Emulates @code{vfork} by calling @code{fork} and returning its value.
 

diff --git a/libiberty/xatexit.c b/libiberty/xatexit.c
index 6d983a894f4458667f9a3ab46cffa1032cc7f2b5..728254b2c0d818bf54e6ae172ccf162d291716b8 100644 (file)
--- a/libiberty/xatexit.c
+++ b/libiberty/xatexit.c
@@ -11,7 +11,7 @@
 @deftypefun int xatexit (void (*@var{fn}) (void))
 
 Behaves as the standard @code{atexit} function, but with no limit on
 @deftypefun int xatexit (void (*@var{fn}) (void))
 
 Behaves as the standard @code{atexit} function, but with no limit on

-the number of registered functions.  Returns 0 on success, or -1 on
+the number of registered functions.  Returns 0 on success, or @minus{}1 on

 failure.  If you use @code{xatexit} to register functions, you must use
 @code{xexit} to terminate your program.
 
 failure.  If you use @code{xatexit} to register functions, you must use
 @code{xexit} to terminate your program.
 

diff --git a/libiberty/xmalloc.c b/libiberty/xmalloc.c
index 3fc23a91c7a457bc31a62b9da31e9fcf2a276ae3..bf0cf2d6ed4d546349e5ab480143ebaaf4113cca 100644 (file)
--- a/libiberty/xmalloc.c
+++ b/libiberty/xmalloc.c
@@ -29,13 +29,13 @@ a program to contain @code{#define malloc xmalloc} in its source.
 
 @end deftypefn
 
 
 @end deftypefn
 

-@deftypefn Replacement void* xrealloc (void*, size_t)
+@deftypefn Replacement void* xrealloc (void *@var{ptr}, size_t @var{size})

 Reallocate memory without fail.  This routine functions like @code{realloc},
 but will behave the same as @code{xmalloc} if memory cannot be found.
 
 @end deftypefn
 
 Reallocate memory without fail.  This routine functions like @code{realloc},
 but will behave the same as @code{xmalloc} if memory cannot be found.
 
 @end deftypefn
 

-@deftypefn Replacement void* xcalloc (size_t, size_t)
+@deftypefn Replacement void* xcalloc (size_t @var{nelem}, size_t @var{elsize})

 
 Allocate memory without fail, and set it to zero.  This routine functions
 like @code{calloc}, but will behave the same as @code{xmalloc} if memory
 
 Allocate memory without fail, and set it to zero.  This routine functions
 like @code{calloc}, but will behave the same as @code{xmalloc} if memory

diff --git a/libiberty/xstrerror.c b/libiberty/xstrerror.c
index 5e57f158202a6e6505650cdf0345f68d740e4ed8..9000d178f9c286d683cda570c5ee3bc4309f1ab7 100644 (file)
--- a/libiberty/xstrerror.c
+++ b/libiberty/xstrerror.c
@@ -7,7 +7,7 @@
 @deftypefn Replacement char* xstrerror (int @var{errnum})
 
 Behaves exactly like the standard @code{strerror} function, but
 @deftypefn Replacement char* xstrerror (int @var{errnum})
 
 Behaves exactly like the standard @code{strerror} function, but

-will never return a NULL pointer.
+will never return a @code{NULL} pointer.

 
 @end deftypefn
 
 
 @end deftypefn