From 07ffcfecac22d21774a110db0f65f0387c8f1102 Mon Sep 17 00:00:00 2001 From: Alan Modra Date: Sun, 7 Apr 2019 20:41:49 +0930 Subject: Merge libiberty from gcc --- libiberty/functions.texi | 57 +++++++++++++++++++++++++----------------------- 1 file changed, 30 insertions(+), 27 deletions(-) (limited to 'libiberty/functions.texi') diff --git a/libiberty/functions.texi b/libiberty/functions.texi index 24dcc37..1784ae7 100644 --- a/libiberty/functions.texi +++ b/libiberty/functions.texi @@ -84,7 +84,7 @@ is respectively less than, matching, or greater than the array member. @end deftypefn -@c argv.c:135 +@c argv.c:138 @deftypefn Extension char** buildargv (char *@var{sp}) Given a pointer to a string, parse the string extracting fields @@ -148,7 +148,7 @@ not recommended. @end deftypefn -@c make-temp-file.c:96 +@c make-temp-file.c:95 @deftypefn Replacement const char* choose_tmpdir () Returns a pointer to a directory path suitable for creating temporary @@ -175,7 +175,7 @@ Concatenate zero or more of strings and return the result in freshly @end deftypefn -@c argv.c:470 +@c argv.c:487 @deftypefn Extension int countargv (char * const *@var{argv}) Return the number of elements in @var{argv}. @@ -183,7 +183,7 @@ Returns zero if @var{argv} is NULL. @end deftypefn -@c crc32.c:141 +@c crc32.c:140 @deftypefn Extension {unsigned int} crc32 (const unsigned char *@var{buf}, @ int @var{len}, unsigned int @var{init}) @@ -192,10 +192,9 @@ starting value is @var{init}; this may be used to compute the CRC of data split across multiple buffers by passing the return value of each call as the @var{init} parameter of the next. -This is intended to match the CRC used by the @command{gdb} remote -protocol for the @samp{qCRC} command. In order to get the same -results as gdb for a block of data, you must pass the first CRC -parameter as @code{0xffffffff}. +This is used by the @command{gdb} remote protocol for the @samp{qCRC} +command. In order to get the same results as gdb for a block of data, +you must pass the first CRC parameter as @code{0xffffffff}. This CRC can be specified as: @@ -212,7 +211,7 @@ make it easy to compose the values of multiple blocks. @end deftypefn -@c argv.c:52 +@c argv.c:59 @deftypefn Extension char** dupargv (char * const *@var{vector}) Duplicate an argument vector. Simply scans through @var{vector}, @@ -223,7 +222,7 @@ argument vector. @end deftypefn -@c strerror.c:567 +@c strerror.c:572 @deftypefn Extension int errno_max (void) Returns the maximum @code{errno} value for which a corresponding @@ -241,7 +240,7 @@ symbolic name or message. @end deftypefn -@c argv.c:341 +@c argv.c:344 @deftypefn Extension void expandargv (int *@var{argcp}, char ***@var{argvp}) The @var{argcp} and @code{argvp} arguments are pointers to the usual @@ -410,7 +409,7 @@ unchanged. @end deftypefn -@c argv.c:90 +@c argv.c:93 @deftypefn Extension void freeargv (char **@var{vector}) Free an argument vector that was built using @code{buildargv}. Simply @@ -431,7 +430,7 @@ unchanged. @end deftypefn -@c getruntime.c:82 +@c getruntime.c:86 @deftypefn Replacement long get_run_time (void) Returns the time used so far, in microseconds. If possible, this is @@ -515,7 +514,7 @@ systems. @end deftypefn -@c safe-ctype.c:25 +@c safe-ctype.c:24 @defvr Extension HOST_CHARSET This macro indicates the basic character set and encoding used by the host: more precisely, the encoding used for character constants in @@ -537,7 +536,7 @@ nineteen EBCDIC varying characters is tested; exercise caution.) @end ftable @end defvr -@c hashtab.c:328 +@c hashtab.c:327 @deftypefn Supplemental htab_t htab_create_typed_alloc (size_t @var{size}, @ htab_hash @var{hash_f}, htab_eq @var{eq_f}, htab_del @var{del_f}, @ htab_alloc @var{alloc_tab_f}, htab_alloc @var{alloc_f}, @ @@ -586,7 +585,7 @@ struct qelem @{ @end deftypefn -@c safe-ctype.c:46 +@c safe-ctype.c:45 @deffn Extension ISALPHA (@var{c}) @deffnx Extension ISALNUM (@var{c}) @deffnx Extension ISBLANK (@var{c}) @@ -636,7 +635,7 @@ false for characters with numeric values from 128 to 255. @end itemize @end deffn -@c safe-ctype.c:95 +@c safe-ctype.c:94 @deffn Extension ISIDNUM (@var{c}) @deffnx Extension ISIDST (@var{c}) @deffnx Extension IS_VSPACE (@var{c}) @@ -684,7 +683,7 @@ components will be simplified. The returned value will be allocated using @end deftypefn -@c make-relative-prefix.c:24 +@c make-relative-prefix.c:23 @deftypefn Extension {const char*} make_relative_prefix (const char *@var{progname}, @ const char *@var{bin_prefix}, const char *@var{prefix}) @@ -710,7 +709,7 @@ relative prefix can be found, return @code{NULL}. @end deftypefn -@c make-temp-file.c:174 +@c make-temp-file.c:173 @deftypefn Replacement char* make_temp_file (const char *@var{suffix}) Return a temporary file name (as a string) or @code{NULL} if unable to @@ -791,7 +790,7 @@ Sets the first @var{count} bytes of @var{s} to the constant byte @end deftypefn -@c mkstemps.c:58 +@c mkstemps.c:60 @deftypefn Replacement int mkstemps (char *@var{pattern}, int @var{suffix_len}) Generate a unique temporary file name from @var{pattern}. @@ -1204,7 +1203,7 @@ deprecated in new programs in favor of @code{strrchr}. @end deftypefn -@c setenv.c:23 +@c setenv.c:22 @deftypefn Supplemental int setenv (const char *@var{name}, @ const char *@var{value}, int @var{overwrite}) @deftypefnx Supplemental void unsetenv (const char *@var{name}) @@ -1478,7 +1477,7 @@ valid until at least the next call. @end deftypefn -@c splay-tree.c:303 +@c splay-tree.c:305 @deftypefn Supplemental splay_tree splay_tree_new_with_typed_alloc @ (splay_tree_compare_fn @var{compare_fn}, @ splay_tree_delete_key_fn @var{delete_key_fn}, @ @@ -1495,7 +1494,11 @@ different types need to be allocated with different allocators. The splay tree will use @var{compare_fn} to compare nodes, @var{delete_key_fn} to deallocate keys, and @var{delete_value_fn} to -deallocate values. +deallocate values. Keys and values will be deallocated when the +tree is deleted using splay_tree_delete or when a node is removed +using splay_tree_remove. splay_tree_insert will release the previously +inserted key and value using @var{delete_key_fn} and @var{delete_value_fn} +if the inserted key is already found in the tree. @end deftypefn @@ -1549,7 +1552,7 @@ Returns a pointer to a copy of @var{s} in memory obtained from @end deftypefn -@c strerror.c:670 +@c strerror.c:675 @deftypefn Replacement {const char*} strerrno (int @var{errnum}) Given an error number returned from a system call (typically returned @@ -1569,7 +1572,7 @@ valid until the next call to @code{strerrno}. @end deftypefn -@c strerror.c:603 +@c strerror.c:608 @deftypefn Supplemental char* strerror (int @var{errnoval}) Maps an @code{errno} number to an error message string, the contents @@ -1698,7 +1701,7 @@ the location referenced by @var{endptr}. @end deftypefn -@c strerror.c:729 +@c strerror.c:734 @deftypefn Extension int strtoerrno (const char *@var{name}) Given the symbolic name of a error number (e.g., @code{EACCES}), map it @@ -1914,7 +1917,7 @@ does the return value. The third argument is unused in @libib{}. @end deftypefn -@c argv.c:286 +@c argv.c:289 @deftypefn Extension int writeargv (char * const *@var{argv}, FILE *@var{file}) Write each member of ARGV, handling all necessary quoting, to the file -- cgit v1.1