Author: Laslo Hunhold <email@example.com>
Date: Tue, 4 Oct 2022 00:17:04 +0200
Rework libgrapheme(7) a bit
Add the information about the library being freestanding and fix
wordings a bit. Reflect in the first paragraph what the library can do.
Signed-off-by: Laslo Hunhold <firstname.lastname@example.org>
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/man/libgrapheme.sh b/man/libgrapheme.sh
@@ -11,12 +11,14 @@ cat << EOF
library provides functions to properly handle Unicode strings according
-to the Unicode specification.
+to the Unicode specification in regard to character, word, sentence and
+line segmentation and case detection and conversion.
Unicode strings are made up of user-perceived characters (so-called
.Dq grapheme clusters ,
.Sx MOTIVATION )
-that are made up of one or more Unicode codepoints, which in turn
+that are composed of one or more Unicode codepoints, which in turn
are encoded in one or more bytes in an encoding like UTF-8.
There is a widespread misconception that it was enough to simply
@@ -32,6 +34,10 @@ Despite this complicated multilevel structure of Unicode strings,
provides methods to work with them at the byte-level (i.e. UTF-8
arrays) while also offering codepoint-level methods.
+Additionally, it is a
+library (see ISO/IEC 9899:1999 section 4.6) and thus does not depend on
+a standard library. This makes it easy to use in bare-metal environments.
Every documented function's manual page provides a self-contained
example illustrating the possible usage.