git: b74486181832 - main - libc: locale: flesh out an incomplete comment

From: Kyle Evans <kevans_at_FreeBSD.org>
Date: Fri, 21 Jul 2023 04:27:32 UTC
The branch main has been updated by kevans:

URL: https://cgit.FreeBSD.org/src/commit/?id=b74486181832b664c749bf542c93e6e55bc2ac20

commit b74486181832b664c749bf542c93e6e55bc2ac20
Author:     Kyle Evans <kevans@FreeBSD.org>
AuthorDate: 2023-07-21 04:27:24 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2023-07-21 04:27:24 +0000

    libc: locale: flesh out an incomplete comment
    
    Extrapolate from the context what the intention for the rest of the
    comment probably was -- that the C/POSIX (and now C.UTF-8) locales may
    avoid an allocation and reuse a global table.
    
    Reviewed by:    bapt
    Sponsored by:   Klara, Inc.
    Differential Revision:  https://reviews.freebsd.org/D41087
---
 lib/libc/locale/xlocale_private.h | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/libc/locale/xlocale_private.h b/lib/libc/locale/xlocale_private.h
index 1d7b1a44d36f..149e019d6098 100644
--- a/lib/libc/locale/xlocale_private.h
+++ b/lib/libc/locale/xlocale_private.h
@@ -163,7 +163,10 @@ xlocale_release(void *val)
 
 /**
  * Load functions.  Each takes the name of a locale and a pointer to the data
- * to be initialised as arguments.  Two special values are allowed for the 
+ * to be initialised as arguments.  Three special values are allowed for the
+ * name of the locale: C, POSIX, and C.UTF-8.  When these are used, we may
+ * use some statically defined tables rather than allocating memory for the
+ * locales' use.
  */
 extern void* __collate_load(const char*, locale_t);
 extern void* __ctype_load(const char*, locale_t);