merge from gcc
authorDJ Delorie <dj@redhat.com>
Tue, 18 Sep 2001 21:02:02 +0000 (21:02 +0000)
committerDJ Delorie <dj@redhat.com>
Tue, 18 Sep 2001 21:02:02 +0000 (21:02 +0000)
include/ChangeLog
include/libiberty.h

index f77ca19d104400a86adf87d7da81e9fc123ca0cd..157dbff4db3e33144920b19efb561f5ecb157c5d 100644 (file)
@@ -1,3 +1,8 @@
+2001-09-18  Kaveh R. Ghazi  <ghazi@caip.rutgers.edu>
+
+       * libiberty.h (concat, concat_length, concat_copy, concat_copy2,
+       ACONCAT): Improve comments.
+
 2001-09-18  Alan Modra  <amodra@bigpond.net.au>
 
        * objalloc.h (OBJALLOC_ALIGN): Define using offsetof.
index 43f1b7d401e7fcb937ddbf6b2f22e809cf5b9679..a54e3adf05e096a7f28c5033f9f320cc8354c2e8 100644 (file)
@@ -85,25 +85,29 @@ extern char *basename ();
 
 extern const char *lbasename PARAMS ((const char *));
 
-/* Concatenate an arbitrary number of strings, up to (char *) NULL.
-   Allocates memory using xmalloc.  */
+/* Concatenate an arbitrary number of strings.  You must pass NULL as
+   the last argument of this function, to terminate the list of
+   strings.  Allocates memory using xmalloc.  */
 
 extern char *concat PARAMS ((const char *, ...)) ATTRIBUTE_MALLOC;
 
 /* Determine the length of concatenating an arbitrary number of
-   strings, up to (char *) NULL.  */
+   strings.  You must pass NULL as the last argument of this function,
+   to terminate the list of strings.  */
 
 extern unsigned long concat_length PARAMS ((const char *, ...));
 
 /* Concatenate an arbitrary number of strings into a SUPPLIED area of
-   memory, up to (char *) NULL.  The supplied memory is assumed to be
-   large enough.  */
+   memory.  You must pass NULL as the last argument of this function,
+   to terminate the list of strings.  The supplied memory is assumed
+   to be large enough.  */
 
 extern char *concat_copy PARAMS ((char *, const char *, ...));
 
 /* Concatenate an arbitrary number of strings into a GLOBAL area of
-   memory, up to (char *) NULL.  The supplied memory is assumed to be
-   large enough.  */
+   memory.  You must pass NULL as the last argument of this function,
+   to terminate the list of strings.  The supplied memory is assumed
+   to be large enough.  */
 
 extern char *concat_copy2 PARAMS ((const char *, ...));
 
@@ -111,8 +115,10 @@ extern char *concat_copy2 PARAMS ((const char *, ...));
 
 extern char *libiberty_concat_ptr;
 
-/* Concatenate an arbitrary number of strings, up to (char *) NULL.
-   Allocates memory using alloca.  Arguments are evaluated twice!.  */
+/* Concatenate an arbitrary number of strings.  You must pass NULL as
+   the last argument of this function, to terminate the list of
+   strings.  Allocates memory using alloca.  The arguments are
+   evaluated twice!  */
 #define ACONCAT(ACONCAT_PARAMS) \
   (libiberty_concat_ptr = alloca (concat_length ACONCAT_PARAMS + 1), \
    concat_copy2 ACONCAT_PARAMS)