This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: gcc/libiberty ChangeLog Makefile.in alloca.c a ...
How about this, then? (functions.texi omitted)
2001-10-16 DJ Delorie <dj@redhat.com>
* argv.c, asprintf.c, choose-temp.c, concat.c, cplus-dem.c,
ffs.c, fnmatch.txh, getruntime.c, make-temp-file.c,
mkstemps.c, pexecute.c, random.c, strsitnal.c, vasprintf.c:
Improve manual formatting.
* functions.texi: Regenerate.
Index: argv.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/argv.c,v
retrieving revision 1.10
diff -p -1 -r1.10 argv.c
*** argv.c 2001/10/16 02:50:13 1.10
--- argv.c 2001/10/17 01:39:34
*************** Duplicate an argument vector. Simply sc
*** 68,70 ****
duplicating each argument until the terminating @code{NULL} is found.
! Returns a pointer to the argument vector if successful. Returns
@code{NULL} if there is insufficient memory to complete building the
--- 68,70 ----
duplicating each argument until the terminating @code{NULL} is found.
! Returns a pointer to the argument vector if successful. Returns
@code{NULL} if there is insufficient memory to complete building the
*************** returned result of @code{buildargv}, as
*** 152,154 ****
! Returns a pointer to the argument vector if successful. Returns
@code{NULL} if @var{sp} is @code{NULL} or if there is insufficient
--- 152,154 ----
! Returns a pointer to the argument vector if successful. Returns
@code{NULL} if @var{sp} is @code{NULL} or if there is insufficient
Index: asprintf.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/asprintf.c,v
retrieving revision 1.5
diff -p -1 -r1.5 asprintf.c
*** asprintf.c 2001/10/16 02:50:13 1.5
--- asprintf.c 2001/10/17 01:39:34
*************** Boston, MA 02111-1307, USA. */
*** 32,34 ****
! @deftypefn Extension int asprintf (char **@var{resptr}, char *@var{format}, ...)
--- 32,34 ----
! @deftypefn Extension int asprintf (char **@var{resptr}, const char *@var{format}, ...)
Index: choose-temp.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/choose-temp.c,v
retrieving revision 1.17
diff -p -1 -r1.17 choose-temp.c
*** choose-temp.c 2001/10/16 02:50:13 1.17
--- choose-temp.c 2001/10/17 01:39:35
*************** extern char *choose_tmpdir PARAMS ((void
*** 41,43 ****
! @deftypefn Extension char* choose_temp_base ()
--- 41,43 ----
! @deftypefn Extension char* choose_temp_base (void)
Index: concat.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/concat.c,v
retrieving revision 1.11
diff -p -1 -r1.11 concat.c
*** concat.c 2001/10/16 02:50:13 1.11
--- concat.c 2001/10/17 01:39:35
*************** Boston, MA 02111-1307, USA. */
*** 23,28 ****
! @deftypefn Extension char* concat (char *@var{s1}, char *@var{s2}, ..., @code{NULL})
Concatenate zero or more of strings and return the result in freshly
! xmalloc'd memory. Returns @code{NULL} if insufficient memory is
available. The argument list is terminated by the first @code{NULL}
--- 23,28 ----
! @deftypefn Extension char* concat (const char *@var{s1}, const char *@var{s2}, @dots{}, @code{NULL})
Concatenate zero or more of strings and return the result in freshly
! @code{xmalloc}ed memory. Returns @code{NULL} if insufficient memory is
available. The argument list is terminated by the first @code{NULL}
*************** concat VPARAMS ((const char *first, ...)
*** 176,178 ****
! @deftypefn Extension char* reconcat (char *@var{optr}, char *@var{s1}, ..., @code{NULL})
--- 176,178 ----
! @deftypefn Extension char* reconcat (char *@var{optr}, const char *@var{s1}, @dots{}, @code{NULL})
Index: cplus-dem.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/cplus-dem.c,v
retrieving revision 1.76
diff -p -1 -r1.76 cplus-dem.c
*** cplus-dem.c 2001/10/07 14:45:04 1.76
--- cplus-dem.c 2001/10/17 01:39:59
*************** cplus_demangle_name_to_style (name)
*** 879,881 ****
If MANGLED is a mangled function name produced by GNU C++, then
! a pointer to a malloced string giving a C++ representation
of the name will be returned; otherwise NULL will be returned.
--- 879,881 ----
If MANGLED is a mangled function name produced by GNU C++, then
! a pointer to a @code{malloc}ed string giving a C++ representation
of the name will be returned; otherwise NULL will be returned.
Index: ffs.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/ffs.c,v
retrieving revision 1.2
diff -p -1 -r1.2 ffs.c
*** ffs.c 2001/10/16 02:50:13 1.2
--- ffs.c 2001/10/17 01:39:59
***************
*** 4,6 ****
! Find the first (least significant) bit set in @var{valu}. Bits are
numbered from right to left, starting with bit 1 (corresponding to the
--- 4,6 ----
! Find the first (least significant) bit set in @var{valu}. Bits are
numbered from right to left, starting with bit 1 (corresponding to the
Index: fnmatch.txh
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/fnmatch.txh,v
retrieving revision 1.1
diff -p -1 -r1.1 fnmatch.txh
*** fnmatch.txh 2001/10/16 02:50:13 1.1
--- fnmatch.txh 2001/10/17 01:39:59
*************** brackets, like @samp{[a-gt8]}, which mat
*** 8,10 ****
through @code{g}, or @code{t}, or @code{8}, in this example) if that one
! character is in the set. A set may be inverted (i.e. match anything
except what's in the set) by giving @code{^} or @code{!} as the first
--- 8,10 ----
through @code{g}, or @code{t}, or @code{8}, in this example) if that one
! character is in the set. A set may be inverted (i.e., match anything
except what's in the set) by giving @code{^} or @code{!} as the first
*************** backslash, use @samp{\\}.
*** 19,21 ****
boolean OR of zero or more of the following values (defined in
! @code{<fnmatch.h>}:
--- 19,21 ----
boolean OR of zero or more of the following values (defined in
! @code{<fnmatch.h>}):
Index: getruntime.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/getruntime.c,v
retrieving revision 1.8
diff -p -1 -r1.8 getruntime.c
*** getruntime.c 2001/10/16 02:50:13 1.8
--- getruntime.c 2001/10/17 01:40:06
*************** Boston, MA 02111-1307, USA. */
*** 77,79 ****
! @deftypefn Replacement long get_run_time ()
--- 77,79 ----
! @deftypefn Replacement long get_run_time (void)
Index: make-temp-file.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/make-temp-file.c,v
retrieving revision 1.4
diff -p -1 -r1.4 make-temp-file.c
*** make-temp-file.c 2001/10/16 02:50:13 1.4
--- make-temp-file.c 2001/10/17 01:40:06
*************** Return a temporary file name (as a strin
*** 141,143 ****
create one. @var{suffix} is a suffix to append to the file name. The
! string is malloced, and the temporary file has been created.
--- 141,143 ----
create one. @var{suffix} is a suffix to append to the file name. The
! string is @code{malloc}ed, and the temporary file has been created.
Index: mkstemps.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/mkstemps.c,v
retrieving revision 1.5
diff -p -1 -r1.5 mkstemps.c
*** mkstemps.c 2001/10/16 02:50:13 1.5
--- mkstemps.c 2001/10/17 01:40:06
*************** Generate a unique temporary file name fr
*** 59,66 ****
@example
! <path>/ccXXXXXX<suffix>
@end example
! @var{suffix_len} tells us how long <suffix> is (it can be zero
! length). The last six characters of @var{template} before <suffix>
! must be @code{XXXXXX}; they are replaced with a string that makes the
filename unique. Returns a file descriptor open on the file for
--- 59,66 ----
@example
! @var{path}/ccXXXXXX@var{suffix}
@end example
! @var{suffix_len} tells us how long @var{suffix} is (it can be zero
! length). The last six characters of @var{template} before @var{suffix}
! must be @samp{XXXXXX}; they are replaced with a string that makes the
filename unique. Returns a file descriptor open on the file for
Index: pexecute.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/pexecute.c,v
retrieving revision 1.22
diff -p -1 -r1.22 pexecute.c
*** pexecute.c 2001/10/16 02:50:13 1.22
--- pexecute.c 2001/10/17 01:40:06
*************** Executes a program.
*** 73,75 ****
! @var{this_pname} is name of the calling program (i.e. @code{argv[0]}).
--- 73,75 ----
! @var{this_pname} is name of the calling program (i.e., @code{argv[0]}).
*************** can pass @code{NULL}.
*** 80,85 ****
! (@var{flags} & @code{PEXECUTE_SEARCH}) is non-zero if @code{$PATH} should be searched
! (??? It's not clear that GCC passes this flag correctly). (@var{flags} &
! @code{PEXECUTE_FIRST}) is nonzero for the first process in chain.
! (@var{flags} & @code{PEXECUTE_FIRST}) is nonzero for the last process
in chain. The first/last flags could be simplified to only mark the
--- 80,85 ----
! (@code{@var{flags} & PEXECUTE_SEARCH}) is non-zero if @env{PATH} should be searched
! (??? It's not clear that GCC passes this flag correctly). (@code{@var{flags} &
! PEXECUTE_FIRST}) is nonzero for the first process in chain.
! (@code{@var{flags} & PEXECUTE_FIRST}) is nonzero for the last process
in chain. The first/last flags could be simplified to only mark the
*************** use @code{spawn}. It is up to the calle
*** 93,95 ****
! The result is the WEXITSTATUS on systems like MS-DOS where we
@code{spawn} and wait for the child here.
--- 93,95 ----
! The result is the @code{WEXITSTATUS} on systems like MS-DOS where we
@code{spawn} and wait for the child here.
*************** Upon failure, @var{errmsg_fmt} and @var{
*** 98,100 ****
text of the error message with an optional argument (if not needed,
! @var{errmsg_arg} is set to @code{NULL}), and -1 is returned.
@code{errno} is available to the caller to use.
--- 98,100 ----
text of the error message with an optional argument (if not needed,
! @var{errmsg_arg} is set to @code{NULL}), and @minus{}1 is returned.
@code{errno} is available to the caller to use.
Index: random.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/random.c,v
retrieving revision 1.7
diff -p -1 -r1.7 random.c
*** random.c 2001/10/16 02:50:13 1.7
--- random.c 2001/10/17 01:40:22
***************
*** 38,40 ****
! @deftypefn Supplement {long int} random ()
@deftypefnx Supplement void srandom (unsigned int @var{seed})
--- 38,40 ----
! @deftypefn Supplement {long int} random (void)
@deftypefnx Supplement void srandom (unsigned int @var{seed})
***************
*** 44,49 ****
Random number functions. @code{random} returns a random number in the
! range @code{0..LONG_MAX}. @code{srandom} initializes the random
number generator to some starting point determined by @var{seed}
(else, the values returned by @code{random} are always the same for each
! run of the program). @code{initstate} and @code{setstate} allow fine-grain
control over the state of the random number generator.
--- 44,49 ----
Random number functions. @code{random} returns a random number in the
! range 0 to @code{LONG_MAX}. @code{srandom} initializes the random
number generator to some starting point determined by @var{seed}
(else, the values returned by @code{random} are always the same for each
! run of the program). @code{initstate} and @code{setstate} allow fine-grained
control over the state of the random number generator.
Index: strsignal.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/strsignal.c,v
retrieving revision 1.9
diff -p -1 -r1.9 strsignal.c
*** strsignal.c 2001/10/16 02:50:13 1.9
--- strsignal.c 2001/10/17 01:40:22
*************** init_signal_tables ()
*** 352,354 ****
! @deftypefn Extension int signo_max ()
--- 352,354 ----
! @deftypefn Extension int signo_max (void)
Index: vasprintf.c
===================================================================
RCS file: /cvs/gcc/gcc/libiberty/vasprintf.c,v
retrieving revision 1.9
diff -p -1 -r1.9 vasprintf.c
*** vasprintf.c 2001/10/16 02:50:13 1.9
--- vasprintf.c 2001/10/17 01:40:22
*************** int global_total_width;
*** 47,49 ****
! @deftypefn Extension int vasprintf (char **@var{resptr}, char *@var{format}, va_list @var{args})
--- 47,49 ----
! @deftypefn Extension int vasprintf (char **@var{resptr}, const char *@var{format}, va_list @var{args})