From 7f8fa05daed1a59589d41a1edbe7db47825c57c0 Mon Sep 17 00:00:00 2001
From: Joseph Myers <jsm28@cam.ac.uk>
Date: Sun, 7 Oct 2001 22:53:31 +0100
Subject: [PATCH] alloca.c, [...]: Improve manual formatting.
* 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.
From-SVN: r46068
---
libiberty/ChangeLog | 10 +++++++
libiberty/alloca.c | 4 +--
libiberty/clock.c | 2 +-
libiberty/functions.texi | 58 ++++++++++++++++++++--------------------
libiberty/getcwd.c | 4 +--
libiberty/getpagesize.c | 2 +-
libiberty/getpwd.c | 2 +-
libiberty/index.c | 2 +-
libiberty/libiberty.texi | 4 +--
libiberty/memchr.c | 6 ++---
libiberty/putenv.c | 2 +-
libiberty/rindex.c | 2 +-
libiberty/strchr.c | 2 +-
libiberty/strdup.c | 2 +-
libiberty/strerror.c | 10 +++----
libiberty/strrchr.c | 2 +-
libiberty/strstr.c | 2 +-
libiberty/strtod.c | 2 +-
libiberty/tmpnam.c | 2 +-
libiberty/vfork.c | 2 +-
libiberty/xatexit.c | 2 +-
libiberty/xmalloc.c | 4 +--
libiberty/xstrerror.c | 2 +-
23 files changed, 70 insertions(+), 60 deletions(-)
diff --git a/libiberty/ChangeLog b/libiberty/ChangeLog
index 98c091698cdb..93408dc3b973 100644
--- 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.
diff --git a/libiberty/alloca.c b/libiberty/alloca.c
index 9c07e0d481c2..e98a053fbee5 100644
--- 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
@@ -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
-the possibility of a GCC builtin function.
+the possibility of a GCC built-in function.
@end deftypefn
diff --git a/libiberty/clock.c b/libiberty/clock.c
index 187af7049c21..3ea70c31c603 100644
--- 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
diff --git a/libiberty/functions.texi b/libiberty/functions.texi
index c00d047dfa80..4ce7e9caa9d1 100644
--- 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
-@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
@@ -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
-the possibility of a GCC builtin function.
+the possibility of a GCC built-in function.
@end deftypefn
@@ -86,7 +86,7 @@ Uses @code{malloc} to allocate storage for @var{nelem} objects of
@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
@@ -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
-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.
@@ -113,20 +113,20 @@ symbolic name or message.
@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
-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
-@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
@@ -136,7 +136,7 @@ memory management hardware page size.
@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}
@@ -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
-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
@@ -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})
-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
-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
@@ -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
-@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
@@ -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
-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
@@ -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
-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
@@ -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
-@code{malloc}, or NULL if insufficient memory was available.
+@code{malloc}, or @code{NULL} if insufficient memory was available.
@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
-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
@@ -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
-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}.
@@ -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
-@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}.
@@ -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
-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
@@ -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
-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}.
@@ -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
-@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
@@ -364,7 +364,7 @@ the location referenced by @var{endptr}.
@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
@@ -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,
-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
-@deftypefn Supplemental int vfork ()
+@deftypefn Supplemental int vfork (void)
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
-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
-@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
@@ -491,7 +491,7 @@ allocated, the remaining memory is zeroed.
@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.
@@ -509,7 +509,7 @@ obtain memory.
@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
diff --git a/libiberty/getcwd.c b/libiberty/getcwd.c
index 8c7c04ceb4e8..465b4e0b2aa4 100644
--- 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
-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}.
diff --git a/libiberty/getpagesize.c b/libiberty/getpagesize.c
index 05b8110ad3ca..eed9680378a7 100644
--- 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
diff --git a/libiberty/getpwd.c b/libiberty/getpwd.c
index c5408794a276..f508b1e21e52 100644
--- 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}
diff --git a/libiberty/index.c b/libiberty/index.c
index 55a4acc17c2f..a2e272783b90 100644
--- 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
-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
diff --git a/libiberty/libiberty.texi b/libiberty/libiberty.texi
index a13bf2c4e172..4b60d6a07fb9 100644
--- 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
-
+@contents
+@page
@ifnottex
@node Top,Using,,
@@ -319,6 +320,5 @@ SUCH DAMAGE.
@printindex cp
-@contents
@bye
diff --git a/libiberty/memchr.c b/libiberty/memchr.c
index f053be71dc59..f94bea018f53 100644
--- 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})
-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
-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
diff --git a/libiberty/putenv.c b/libiberty/putenv.c
index a655b59f8e35..58012fc83ad2 100644
--- 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
-@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
diff --git a/libiberty/rindex.c b/libiberty/rindex.c
index 9c25dff4dcc4..ef9cdc59877d 100644
--- 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
-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
diff --git a/libiberty/strchr.c b/libiberty/strchr.c
index 6f327f2a2418..1f71c5143d08 100644
--- 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
-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
diff --git a/libiberty/strdup.c b/libiberty/strdup.c
index a01cedfbee03..49233ba7aac9 100644
--- 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
-@code{malloc}, or NULL if insufficient memory was available.
+@code{malloc}, or @code{NULL} if insufficient memory was available.
@end deftypefn
diff --git a/libiberty/strerror.c b/libiberty/strerror.c
index 046ffe6a1b74..37fbf4d0a8bc 100644
--- 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
-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.
@@ -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
-@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}.
@@ -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
-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
@@ -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
-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}.
@@ -729,7 +729,7 @@ strerrno (errnoval)
@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
diff --git a/libiberty/strrchr.c b/libiberty/strrchr.c
index 9dc31f2a1597..bc380c4c5d30 100644
--- 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
-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
diff --git a/libiberty/strstr.c b/libiberty/strstr.c
index ffe1d10fc9ef..470e04b1a761 100644
--- 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
-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}.
diff --git a/libiberty/strtod.c b/libiberty/strtod.c
index 2f0a0762fc36..874e5e524162 100644
--- 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
-@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
diff --git a/libiberty/tmpnam.c b/libiberty/tmpnam.c
index 99615df7fe5d..406878c49a3e 100644
--- 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,
-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
diff --git a/libiberty/vfork.c b/libiberty/vfork.c
index 7df7a2262606..4aa5c21d4271 100644
--- 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.
diff --git a/libiberty/xatexit.c b/libiberty/xatexit.c
index 6d983a894f44..728254b2c0d8 100644
--- 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
-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.
diff --git a/libiberty/xmalloc.c b/libiberty/xmalloc.c
index 3fc23a91c7a4..bf0cf2d6ed4d 100644
--- 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
-@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
-@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
diff --git a/libiberty/xstrerror.c b/libiberty/xstrerror.c
index 5e57f158202a..9000d178f9c2 100644
--- 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
-will never return a NULL pointer.
+will never return a @code{NULL} pointer.
@end deftypefn
--
GitLab