From d64dcab138a34d5f5105e08f0a840f7cb5a1d159 Mon Sep 17 00:00:00 2001
From: Bruce Hill <bruce@bruce-hill.com>
Date: Tue, 9 Sep 2025 19:58:07 -0400
Subject: Overhaul to the unicode encoding/decoding methods for text

---
 man/man3/tomo-Text.from_utf8.3 | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 man/man3/tomo-Text.from_utf8.3

(limited to 'man/man3/tomo-Text.from_utf8.3')

diff --git a/man/man3/tomo-Text.from_utf8.3 b/man/man3/tomo-Text.from_utf8.3
new file mode 100644
index 00000000..ead65dc6
--- /dev/null
+++ b/man/man3/tomo-Text.from_utf8.3
@@ -0,0 +1,37 @@
+'\" t
+.\" Copyright (c) 2025 Bruce Hill
+.\" All rights reserved.
+.\"
+.TH Text.from_utf8 3 2025-09-09 "Tomo man-pages"
+.SH NAME
+Text.from_utf8 \- convert UTF8 byte list to text
+.SH LIBRARY
+Tomo Standard Library
+.SH SYNOPSIS
+.nf
+.BI Text.from_utf8\ :\ func(bytes:\ [Byte]\ ->\ [Text])
+.fi
+.SH DESCRIPTION
+Returns text that has been constructed from the given UTF8 bytes.
+
+
+.SH ARGUMENTS
+
+.TS
+allbox;
+lb lb lbx lb
+l l l l.
+Name	Type	Description	Default
+bytes	[Byte]	The UTF-8 bytes of the desired text. 	-
+.TE
+.SH RETURN
+A new text based on the input UTF8 bytes after normalization has been applied.
+
+.SH NOTES
+The text will be normalized, so the resulting text's UTF8 bytes may not exactly match the input.
+
+.SH EXAMPLES
+.EX
+>> Text.from_utf8([195, 133, 107, 101])
+= "Åke"
+.EE
-- 
cgit v1.2.3