Comment tweaks.

diff --git a/ChangeLog b/ChangeLog
index 7e08cfcf8ad8c42a5a29c14f7f05fc1ac88ecfa9..e79d5f9a8fa7fe21ac9fa9ef6f653f369fdd7343 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2009-04-28  Bruno Haible  <bruno@clisp.org>
+
+       Comment tweaks.
+       * lib/unistr.h (u*_cmp2): Clarify what memcmp2 is.
+       * lib/uninorm.h (u*_normxfrm): Fix description of return value.
+       * lib/unicase.h (u*_casexfrm): Likewise.
+       Reported by Paolo Bonzini.
+
 2009-04-28  Bruno Haible  <bruno@clisp.org>
 
        Fix a compilation error.

diff --git a/lib/unicase.h b/lib/unicase.h
index ff7590bad9069c9c506feb49c0d291b1eedb1154..fdd74929b77e9086dc6b67a27aeee9f7684c5157 100644 (file)
--- a/lib/unicase.h
+++ b/lib/unicase.h
@@ -174,9 +174,9 @@ extern int
                    const char *s2, size_t n2,
                    const char *iso639_language, uninorm_t nf, int *resultp);
 
-/* Convert the string S of length N to a string in locale encoding, in such a
-   way that comparing uN_casexfrm (S1) and uN_casexfrm (S2) with memcmp2() is
-   equivalent to comparing S1 and S2 with uN_casecoll().
+/* Convert the string S of length N to a NUL-terminated byte sequence, in such
+   a way that comparing uN_casexfrm (S1) and uN_casexfrm (S2) with the gnulib
+   function memcmp2() is equivalent to comparing S1 and S2 with uN_casecoll().
    NF must be either UNINORM_NFC, UNINORM_NFKC, or NULL for no normalization.  */
 extern char *
        u8_casexfrm (const uint8_t *s, size_t n, const char *iso639_language,

diff --git a/lib/uninorm.h b/lib/uninorm.h
index 5892522d5568ab43c424b45c0d73c73b4e38ee4c..42a6dc17b67aa344094e9a6818300539397ce16e 100644 (file)
--- a/lib/uninorm.h
+++ b/lib/uninorm.h
@@ -164,8 +164,8 @@ extern int
                    uninorm_t nf, int *resultp);
 
 
-/* Converts the string S of length N to a string in locale encoding, in such a
-   way that comparing uN_normxfrm (S1) and uN_normxfrm (S2) with uN_cmp2() is
+/* Converts the string S of length N to a NUL-terminated byte sequence, in such
+   a way that comparing uN_normxfrm (S1) and uN_normxfrm (S2) with uN_cmp2() is
    equivalent to comparing S1 and S2 with uN_normcoll().
    NF must be either UNINORM_NFC or UNINORM_NFKC.  */
 extern char *

diff --git a/lib/unistr.h b/lib/unistr.h
index 16b26693a3dc7dc963e9b9812a30a798330d459a..83ff13411dc79071d89705571310d139b975522c 100644 (file)
--- a/lib/unistr.h
+++ b/lib/unistr.h
@@ -403,7 +403,7 @@ extern int
        u32_cmp (const uint32_t *s1, const uint32_t *s2, size_t n);
 
 /* Compare S1 and S2.  */
-/* Similar to memcmp2().  */
+/* Similar to the gnulib function memcmp2().  */
 extern int
        u8_cmp2 (const uint8_t *s1, size_t n1, const uint8_t *s2, size_t n2);
 extern int