From f56ff6b35bc3869a7d7c4191e06e79c1338caac3 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Wed, 29 Apr 2009 03:02:27 +0200 Subject: [PATCH] Comment tweaks. --- ChangeLog | 8 ++++++++ lib/unicase.h | 6 +++--- lib/uninorm.h | 4 ++-- lib/unistr.h | 2 +- 4 files changed, 14 insertions(+), 6 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7e08cfcf8a..e79d5f9a8f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2009-04-28 Bruno Haible + + 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 Fix a compilation error. diff --git a/lib/unicase.h b/lib/unicase.h index ff7590bad9..fdd74929b7 100644 --- 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 5892522d55..42a6dc17b6 100644 --- 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 16b26693a3..83ff13411d 100644 --- 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 -- 2.30.2