aboutsummaryrefslogtreecommitdiff
path: root/vendor/librune/README.md
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2024-01-27 23:26:42 +0100
committerThomas Voss <mail@thomasvoss.com> 2024-01-27 23:26:42 +0100
commit679f7928e27a95e559eb3a69febf0c6336e40234 (patch)
treeaf9c5bb35253086eb8e3ad3d7774e7349b3beefe /vendor/librune/README.md
parentfd502fd87b40ae7f60314d8d9009f739f1c5fcf3 (diff)
Bump librune
Diffstat (limited to 'vendor/librune/README.md')
-rw-r--r--vendor/librune/README.md38
1 files changed, 32 insertions, 6 deletions
diff --git a/vendor/librune/README.md b/vendor/librune/README.md
index 5431551..6e1f772 100644
--- a/vendor/librune/README.md
+++ b/vendor/librune/README.md
@@ -4,8 +4,7 @@ Librune is a C library that aims to make interacting with Unicode and
UTF-8 easy in C. There are no plans at the moment to support UTF-16 or
-32, but they may be supported if such a usecase ever comes up.
-This library has been tested to build and work properly on both C99 and
-C23.
+This library requires C23.
## Terminology
@@ -19,10 +18,37 @@ represents a rune (shocker).
This library contains the following headers:
-1. `gbrk.h` — grapheme-iteration functions
-2. `rune.h` — rune-constants, -macros, and -functions
-3. `utf8.h` — UTF-8 encoding, decoding, iteration, etc.
-4. `builder.h` — string building functions
+- `builder.h` — string building functions
+- `gbrk.h` — grapheme-iteration functions
+- `rtype.h` — rune categorization à la `ctype.h`
+- `rune.h` — rune-constants, -macros, and -functions
+- `utf8.h` — UTF-8 encoding, decoding, iteration, etc.
+
+
+## Compilation
+
+This library comes with a build script in the form of `make.c`. To build
+the library all you need is a C compiler. The build script will build a
+static library called ‘librune.a’.
+
+```sh
+# Make sure to link with pthread
+cc -lpthread -o make make.c
+./make
+```
+
+If you want to build the library in release-mode (optimizations enabled),
+simply pass the `-r` flag to the build script:
+
+```sh
+./make -r
+```
+
+You can also pass the `-l` flag to enable link-time optimizations:
+
+```sh
+./make -lr
+```
## Installation