Author: Laslo Hunhold <firstname.lastname@example.org>
Date: Wed, 22 Dec 2021 13:46:07 +0100
Add README and change title and introduction in Makefile and manuals
Signed-off-by: Laslo Hunhold <email@example.com>
3 files changed, 52 insertions(+), 5 deletions(-)
diff --git a/Makefile b/Makefile
@@ -1,5 +1,5 @@
# See LICENSE file for copyright and license details
-# libgrapheme - grapheme cluster utility library
+# libgrapheme - unicode string library
diff --git a/README b/README
@@ -0,0 +1,38 @@
+The libgrapheme library provides functions to properly handle Unicode
+strings according to the Unicode specification. Unicode strings are made
+up of user-perceived characters (so-called "grapheme clusters") that are
+made up of one or more Unicode codepoints, which in turn are encoded in
+one or more bytes in an encoding like UTF-8.
+Despite the complicated multilevel structure of Unicode strings,
+libgrapheme provides methods to work with them at the byte-level (i.e.
+UTF-8 ‘char’ arrays) while also providing codepoint-level methods.
+See libgrapheme(7) to get started and try out the self-contained examples
+given on the manual pages for each function.
+A C99-compiler and POSIX make.
+Edit config.mk to match your local setup (usually not necessary, the
+default prefix is /usr/local).
+Afterwards enter the following command to build and install libgrapheme
+(if necessary as root):
+ make install
+Include the header grapheme.h in your code and link against libgrapheme
+with "-lgrapheme" either statically ("-static") or dynamically.
+Laslo Hunhold <firstname.lastname@example.org>
diff --git a/man/libgrapheme.7 b/man/libgrapheme.7
@@ -3,17 +3,26 @@
-.Nd unicode library
+.Nd unicode string library
-library provides functions to properly handle user-perceived characters
-.Dq ( grapheme clusters ,
+library provides functions to properly handle Unicode strings according
+to the Unicode specification.
+Unicode strings are made up of user-perceived characters (so-called
+.Dq grapheme clusters ,
.Sx MOTIVATION )
-according to the Unicode specification.
+that are made up of one or more Unicode codepoints, which in turn
+are encoded in one or more bytes in an encoding like UTF-8.
+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.
.Sh SEE ALSO
.Xr grapheme_decode_utf8 3 ,
.Xr grapheme_encode_utf8 3 ,