summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/u8c_abrt.33
-rw-r--r--docs/u8c_col.335
-rw-r--r--docs/u8c_dbg.31
-rw-r--r--docs/u8c_dbgprint.31
-rw-r--r--docs/u8c_end.31
-rw-r--r--docs/u8c_errhandltyp.31
-rw-r--r--docs/u8c_errtyp.31
-rw-r--r--docs/u8c_fmt.31
-rw-r--r--docs/u8c_fmttyp.31
-rw-r--r--docs/u8c_geterr.31
-rw-r--r--docs/u8c_init.31
-rw-r--r--docs/u8c_isalnum.31
-rw-r--r--docs/u8c_isalpha.31
-rw-r--r--docs/u8c_iscntrl.31
-rw-r--r--docs/u8c_isdigit.31
-rw-r--r--docs/u8c_ispunct.31
-rw-r--r--docs/u8c_isspace.31
-rw-r--r--docs/u8c_isxdigit.31
-rw-r--r--docs/u8c_print.31
-rw-r--r--docs/u8c_println.31
-rw-r--r--docs/u8c_regerrhandl.31
-rw-r--r--docs/u8c_seterr.31
-rw-r--r--docs/u8c_setfmt.31
-rw-r--r--docs/u8c_thrdsafe.31
-rw-r--r--docs/u8c_u16alloc.320
-rw-r--r--docs/u8c_u16free.319
-rw-r--r--docs/u8c_u32alloc.31
-rw-r--r--docs/u8c_u32cat.31
-rw-r--r--docs/u8c_u32cmp.31
-rw-r--r--docs/u8c_u32cp.31
-rw-r--r--docs/u8c_u32fndchr.31
-rw-r--r--docs/u8c_u32fndpat.31
-rw-r--r--docs/u8c_u32free.33
-rw-r--r--docs/u8c_u32ins.31
-rw-r--r--docs/u8c_u32substr.31
-rw-r--r--docs/u8c_u32sz.31
-rw-r--r--docs/u8c_u8alloc.31
-rw-r--r--docs/u8c_u8dec.31
-rw-r--r--docs/u8c_u8enc.31
-rw-r--r--docs/u8c_u8free.33
-rw-r--r--docs/u8c_unimax.31
-rw-r--r--docs/u8c_ver.31
-rw-r--r--docs/u8c_vfmt.31
-rw-r--r--docs/u8c_vprint.31
44 files changed, 101 insertions, 20 deletions
diff --git a/docs/u8c_abrt.3 b/docs/u8c_abrt.3
index 0445701..6ea816c 100644
--- a/docs/u8c_abrt.3
+++ b/docs/u8c_abrt.3
@@ -6,6 +6,7 @@ u8c_abrt - Abort - Abort program with diagnostic information.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdbool.h
# include <stdnoreturn.h>
# include <uchar.h>
@@ -16,7 +17,7 @@ extern noreturn bool u8c_abrt(char const * const fl,long long const ln,char cons
.PP
The function \f[B]u8c_abrt\f[R] aborts the program and prints diagnostic infiormation to \f[B]stderr\f[R].
.PP
-\f[B]__FILE__\f[R] is to be passed at \f[B]fl\f[R], \f[B](long long)__LINE__\f[R] at \f[B]ln\f[B], and \f[B]__func__\f[R] at \f[B]fn\f[R]. A standard string (\f[B]char const *\f[R]) must be passed at \f[B]why\f[R], which explains the reason for aborting.
+\f[B]__FILE__\f[R] is to be passed at \f[B]fl\f[R], \f[B](long long)__LINE__\f[R] at \f[B]ln\f[R], and \f[B]__func__\f[R] at \f[B]fn\f[R]. A standard string (\f[B]char const *\f[R]) must be passed at \f[B]why\f[R], which explains the reason for aborting.
.PP
All arguments are printed, in the end followed by a timestamp representing the number of seconds passed since the current epoch (as returned by \f[B]time(NULL)\f[R]).
.SH VERSION
diff --git a/docs/u8c_col.3 b/docs/u8c_col.3
index b0fb658..784a67d 100644
--- a/docs/u8c_col.3
+++ b/docs/u8c_col.3
@@ -6,28 +6,29 @@ u8c_col - Colour - Set of macros expanding to hexadecimal colour value expressio
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdint.h>
-# define u8c_col_azure (UINT32_C(0x3DA9E1))
-# define u8c_col_ash (UINT32_C(0xD2D2CC))
-# define u8c_col_black (UINT32_C(0x444747))
-# define u8c_col_blue (UINT32_C(0x3D3DE1))
-# define u8c_col_chartreuse (UINT32_C(0xA9E13D))
-# define u8c_col_cyan (UINT32_C(0x3DE1E1))
-# define u8c_col_green (UINT32_C(0x3ED13D))
-# define u8c_col_magenta (UINT32_C(0xE13DE1))
-# define u8c_col_mint (UINT32_C(0x3DE1A9))
-# define u8c_col_orange (UINT32_C(0xE1A93D))
-# define u8c_col_red (UINT32_C(0xE13D3D))
-# define u8c_col_rose (UINT32_C(0xE13DA9))
-# define u8c_col_silver (UINT32_C(0x9CA1A1))
-# define u8c_col_violet (UINT32_C(0xA93dE1))
-# define u8c_col_white (UINT32_C(0xF8F8F1))
-# define u8c_col_yellow (UINT32_C(0xE1E13D))
+static uint_least32_t const u8c_col_azure = UINT32_C(0x3DA9E1);
+static uint_least32_t const u8c_col_ash = UINT32_C(0xD2D2CC);
+static uint_least32_t const u8c_col_black = UINT32_C(0x444747);
+static uint_least32_t const u8c_col_blue = UINT32_C(0x3D3DE1);
+static uint_least32_t const u8c_col_chartreuse = UINT32_C(0xA9E13D);
+static uint_least32_t const u8c_col_cyan = UINT32_C(0x3DE1E1);
+static uint_least32_t const u8c_col_green = UINT32_C(0x3ED13D);
+static uint_least32_t const u8c_col_magenta = UINT32_C(0xE13DE1);
+static uint_least32_t const u8c_col_mint = UINT32_C(0x3DE1A9);
+static uint_least32_t const u8c_col_orange = UINT32_C(0xE1A93D);
+static uint_least32_t const u8c_col_red = UINT32_C(0xE13D3D);
+static uint_least32_t const u8c_col_rose = UINT32_C(0xE13DA9);
+static uint_least32_t const u8c_col_silver = UINT32_C(0x9CA1A1);
+static uint_least32_t const u8c_col_violet = UINT32_C(0xA93dE1);
+static uint_least32_t const u8c_col_white = UINT32_C(0xF8F8F1);
+static uint_least32_t const u8c_col_yellow = UINT32_C(0xE1E13D);
\f[R]
.fi
.SH DESCRIPTION
.PP
-The macro set \f[B]u8c_col\f[R] contains sixteen macros expanding to hexadecimal colour value expressions of type \f[B]uint_least32_t\f[R].
+The constant set \f[B]u8c_col\f[R] contains sixteen constants with colour values.
.SH VERSION
.PP
u8c 2
diff --git a/docs/u8c_dbg.3 b/docs/u8c_dbg.3
index d1f95eb..d461d4e 100644
--- a/docs/u8c_dbg.3
+++ b/docs/u8c_dbg.3
@@ -6,6 +6,7 @@ u8c_dbg - Debug - Whether or not the library is in debug mode.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdbool.h>
extern bool const u8c_dbg;
\f[R]
diff --git a/docs/u8c_dbgprint.3 b/docs/u8c_dbgprint.3
index e7c609f..3d400dc 100644
--- a/docs/u8c_dbgprint.3
+++ b/docs/u8c_dbgprint.3
@@ -6,6 +6,7 @@ u8c_dbgprint - Debug print - Print line if debug mode is enabled.
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# if defined(NDEBUG)
# define u8c_dbgprint(...) ((void)0x0)
# else
diff --git a/docs/u8c_end.3 b/docs/u8c_end.3
index bf8c81e..593af14 100644
--- a/docs/u8c_end.3
+++ b/docs/u8c_end.3
@@ -6,6 +6,7 @@ u8c_end - End - Finalise u8c and clean up.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdbool.h>
extern bool u8c_end(void);
\f[R]
diff --git a/docs/u8c_errhandltyp.3 b/docs/u8c_errhandltyp.3
index ac7f8e2..0477d2c 100644
--- a/docs/u8c_errhandltyp.3
+++ b/docs/u8c_errhandltyp.3
@@ -6,6 +6,7 @@ u8c_errhandltyp - Error handler type - Type to be used for error handlers passer
.PP
.nf
\f[C]
+/* # include <u8c/err.h> */
# include <u8c/errtyp.h>
typedef void (* u8c_errhandltyp)(enum u8c_errtyp);
\f[R]
diff --git a/docs/u8c_errtyp.3 b/docs/u8c_errtyp.3
index cd0a282..f42ac10 100644
--- a/docs/u8c_errtyp.3
+++ b/docs/u8c_errtyp.3
@@ -6,6 +6,7 @@ u8c_errtyp - Error type - Enumeration for specifying the type of error.
.PP
.nf
\f[C]
+/* # include <u8c/err.h> */
enum u8c_errtyp {
u8c_errtyp_badalloc,
u8c_errtyp_badio,
diff --git a/docs/u8c_fmt.3 b/docs/u8c_fmt.3
index cbb823b..e1499fd 100644
--- a/docs/u8c_fmt.3
+++ b/docs/u8c_fmt.3
@@ -6,6 +6,7 @@ u8c_fmt - Format - Format UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stddef.h>
# include <uchar.h>
extern bool u8c_fmt(size_t * const outsz,char32_t const * * const out,char32_t const * const in,...);
diff --git a/docs/u8c_fmttyp.3 b/docs/u8c_fmttyp.3
index 8cdea7c..04c4391 100644
--- a/docs/u8c_fmttyp.3
+++ b/docs/u8c_fmttyp.3
@@ -6,6 +6,7 @@ u8c_fmttyp - Format type - Format specifier to be used by \f[C]u8c_fmt\f[R] or \
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
enum u8c_fmttyp {
u8c_fmttyp_bgcol,
u8c_fmttyp_bgcol0,
diff --git a/docs/u8c_geterr.3 b/docs/u8c_geterr.3
index c74b25f..e19d50d 100644
--- a/docs/u8c_geterr.3
+++ b/docs/u8c_geterr.3
@@ -6,6 +6,7 @@ u8c_geterr - Get error - Get last error set by \f[C]u8c_seterr\f[R].
.PP
.nf
\f[C]
+/* # include <u8c/err.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_init.3 b/docs/u8c_init.3
index 0491a0b..35f6346 100644
--- a/docs/u8c_init.3
+++ b/docs/u8c_init.3
@@ -6,6 +6,7 @@ u8c_init - Initialise - Initialise and start an u8c session.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdbool.h>
# include <u8c/errtyp.h>
extern bool u8c_init(void);
diff --git a/docs/u8c_isalnum.3 b/docs/u8c_isalnum.3
index c8f9dcc..273c673 100644
--- a/docs/u8c_isalnum.3
+++ b/docs/u8c_isalnum.3
@@ -6,6 +6,7 @@ u8c_isalnum - Is alphanumeric - Check if a character is alphanumeric.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_isalpha.3 b/docs/u8c_isalpha.3
index c6cc372..a063974 100644
--- a/docs/u8c_isalpha.3
+++ b/docs/u8c_isalpha.3
@@ -6,6 +6,7 @@ u8c_isalpha - Is alphabetic - Check if a character is alphabetic.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_iscntrl.3 b/docs/u8c_iscntrl.3
index 1c27b82..b4fa794 100644
--- a/docs/u8c_iscntrl.3
+++ b/docs/u8c_iscntrl.3
@@ -6,6 +6,7 @@ u8c_iscntrl - Is control - Check if a character is a control character.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_isdigit.3 b/docs/u8c_isdigit.3
index 6b3ec4a..0e93230 100644
--- a/docs/u8c_isdigit.3
+++ b/docs/u8c_isdigit.3
@@ -6,6 +6,7 @@ u8c_isdigit - Is digit - Check if a character is a dozenal digit.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_ispunct.3 b/docs/u8c_ispunct.3
index af607cb..db9878e 100644
--- a/docs/u8c_ispunct.3
+++ b/docs/u8c_ispunct.3
@@ -6,6 +6,7 @@ u8c_ispunct - Is punctuation - Check if a character is a punctuation mark.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_isspace.3 b/docs/u8c_isspace.3
index 72ad3e1..e78395d 100644
--- a/docs/u8c_isspace.3
+++ b/docs/u8c_isspace.3
@@ -6,6 +6,7 @@ u8c_isspace - Is space - Check if a character is an whitespace.
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_isxdigit.3 b/docs/u8c_isxdigit.3
index 66c7955..7bb7649 100644
--- a/docs/u8c_isxdigit.3
+++ b/docs/u8c_isxdigit.3
@@ -6,6 +6,7 @@ u8c_isxdigit - Is hexadecimal digit - Check if a character is a hexadecimal digi
.PP
.nf
\f[C]
+/* # include <u8c/is.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_print.3 b/docs/u8c_print.3
index 54a7466..7b5f55f 100644
--- a/docs/u8c_print.3
+++ b/docs/u8c_print.3
@@ -6,6 +6,7 @@ u8c_print - Print - Format UTF-32 and print it to file.
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdbool.h>
# include <stdio.h>
# include <uchar.h>
diff --git a/docs/u8c_println.3 b/docs/u8c_println.3
index 72345a6..14b8131 100644
--- a/docs/u8c_println.3
+++ b/docs/u8c_println.3
@@ -6,6 +6,7 @@ u8c_println - Print line - Format UTF-32 and print it to file (followed by a new
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdbool.h>
# include <stdio.h>
# include <uchar.h>
diff --git a/docs/u8c_regerrhandl.3 b/docs/u8c_regerrhandl.3
index 7b2f824..27be625 100644
--- a/docs/u8c_regerrhandl.3
+++ b/docs/u8c_regerrhandl.3
@@ -6,6 +6,7 @@ u8c_regerrhandl - Register error handler - Register error handler function to be
.PP
.nf
\f[C]
+/* # include <u8c/err.h> */
# include <stdbool.h>
# include <u8c/errhandltyp.h>
# include <u8c/errtyp.h>
diff --git a/docs/u8c_seterr.3 b/docs/u8c_seterr.3
index 49125f5..be9ed98 100644
--- a/docs/u8c_seterr.3
+++ b/docs/u8c_seterr.3
@@ -6,6 +6,7 @@ u8c_seterr - Set error - Set error and call error handler.
.PP
.nf
\f[C]
+/* # include <u8c/err.h> */
# include <stdbool.h>
# include <u8c/errtyp.h>
# include <uchar.h>
diff --git a/docs/u8c_setfmt.3 b/docs/u8c_setfmt.3
index 105019e..65d7646 100644
--- a/docs/u8c_setfmt.3
+++ b/docs/u8c_setfmt.3
@@ -6,6 +6,7 @@ u8c_setfmt - Set format - Set format to be used by \f[B]u8c_fmt\f[R] and company
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdbool.h>
# include <stdint.h>
extern bool u8c_setfmt(uint_least8_t const base,uint_least8_t const endian);
diff --git a/docs/u8c_thrdsafe.3 b/docs/u8c_thrdsafe.3
index b229734..09a0e3f 100644
--- a/docs/u8c_thrdsafe.3
+++ b/docs/u8c_thrdsafe.3
@@ -6,6 +6,7 @@ u8c_thrdsafe - Thread-safe - Whether or not u8c is thread-safe.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdbool.h>
extern bool const u8c_thrdsafe;
\f[R]
diff --git a/docs/u8c_u16alloc.3 b/docs/u8c_u16alloc.3
new file mode 100644
index 0000000..96a59a6
--- /dev/null
+++ b/docs/u8c_u16alloc.3
@@ -0,0 +1,20 @@
+.TH "u8c_u16alloc" "3" "" "u8c" "u8c API Manual"
+.SH NAME
+.PP
+u8c_u16alloc - UTF-16 allocate - Allocate UTF-16 string.
+.SH DECLARATION
+.PP
+.nf
+\f[C]
+/* # include <u8c/u16.h> */
+# include <stdbool.h>
+# include <stddef.h>
+# include <uchar.h>
+extern bool u8c_u16alloc(char16_t * * const u16,size_t const sz);
+\f[R]
+.fi
+.SH DESCRIPTION
+.PP
+.SH VERSION
+.PP
+u8c 20
diff --git a/docs/u8c_u16free.3 b/docs/u8c_u16free.3
new file mode 100644
index 0000000..7674794
--- /dev/null
+++ b/docs/u8c_u16free.3
@@ -0,0 +1,19 @@
+.TH "u8c_u16free" "3" "" "u8c" "u8c API Manual"
+.SH NAME
+.PP
+u8c_u16free - UTF-16 free - Deallocate UTF-16 string and set it to \f[B]NULL\f[R].
+.SH DECLARATION
+.PP
+.nf
+\f[C]
+/* # include <u8c/u16.h> */
+# include <stdbool.h>
+# include <uchar.h>
+extern bool u8c_u16free(char16_t const * * const u16);
+\f[R]
+.fi
+.SH DESCRIPTION
+.PP
+.SH VERSION
+.PP
+u8c 20
diff --git a/docs/u8c_u32alloc.3 b/docs/u8c_u32alloc.3
index 8288f55..4ced722 100644
--- a/docs/u8c_u32alloc.3
+++ b/docs/u8c_u32alloc.3
@@ -6,6 +6,7 @@ u8c_u32alloc - UTF-32 allocate - Allocate UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32cat.3 b/docs/u8c_u32cat.3
index b600f9f..78d8a5c 100644
--- a/docs/u8c_u32cat.3
+++ b/docs/u8c_u32cat.3
@@ -6,6 +6,7 @@ u8c_u32cat - UTF-32 concatenate - Concatenate two UTF-32 strings.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32cmp.3 b/docs/u8c_u32cmp.3
index c4d41bd..2954a8d 100644
--- a/docs/u8c_u32cmp.3
+++ b/docs/u8c_u32cmp.3
@@ -6,6 +6,7 @@ u8c_u32cmp - UTF-32 compare - Compare two UTF-32 strings.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stdint.h>
# include <uchar.h>
diff --git a/docs/u8c_u32cp.3 b/docs/u8c_u32cp.3
index ad28884..507e36e 100644
--- a/docs/u8c_u32cp.3
+++ b/docs/u8c_u32cp.3
@@ -6,6 +6,7 @@ u8c_u32cp - UTF-32 copy - Copy an UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32fndchr.3 b/docs/u8c_u32fndchr.3
index a7f688e..566985e 100644
--- a/docs/u8c_u32fndchr.3
+++ b/docs/u8c_u32fndchr.3
@@ -6,6 +6,7 @@ u8c_u32fndchr - UTF-32 find character - Find the first occurence of an UTF-32 ch
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32fndpat.3 b/docs/u8c_u32fndpat.3
index 1caf194..b74da9b 100644
--- a/docs/u8c_u32fndpat.3
+++ b/docs/u8c_u32fndpat.3
@@ -6,6 +6,7 @@ u8c_u32fndpat - UTF-32 find pattern - Find the first occurence of an UTF-32 patt
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32free.3 b/docs/u8c_u32free.3
index da74052..0dd58f1 100644
--- a/docs/u8c_u32free.3
+++ b/docs/u8c_u32free.3
@@ -1,11 +1,12 @@
.TH "u8c_u32free" "3" "" "u8c" "u8c API Manual"
.SH NAME
.PP
-u8c_u32free - UTF-32 free - Free UTF-32 string.
+u8c_u32free - UTF-32 free - Deallocate UTF-32 string and set it to \f[B]NULL\f[R].
.SH DECLARATION
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <uchar.h>
extern bool u8c_u32free(char32_t const * * const u32);
diff --git a/docs/u8c_u32ins.3 b/docs/u8c_u32ins.3
index ea62cae..8dc54c7 100644
--- a/docs/u8c_u32ins.3
+++ b/docs/u8c_u32ins.3
@@ -6,6 +6,7 @@ u8c_u32ins - UTF-32 insert - Insert an UTF-32 string into another UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32substr.3 b/docs/u8c_u32substr.3
index b35bebe..8615447 100644
--- a/docs/u8c_u32substr.3
+++ b/docs/u8c_u32substr.3
@@ -6,6 +6,7 @@ u8c_u32substr - UTF-32 sub-string - Get sub-string of an UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u32sz.3 b/docs/u8c_u32sz.3
index 0a7fab9..61254b7 100644
--- a/docs/u8c_u32sz.3
+++ b/docs/u8c_u32sz.3
@@ -6,6 +6,7 @@ u8c_u32sz - UTF-32 size - Get the size of an UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/u32.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u8alloc.3 b/docs/u8c_u8alloc.3
index 8fbda08..ab0cf15 100644
--- a/docs/u8c_u8alloc.3
+++ b/docs/u8c_u8alloc.3
@@ -6,6 +6,7 @@ u8c_u8alloc - UTF-8 allocate - Allocate UTF-8 string.
.PP
.nf
\f[C]
+/* # include <u8c/u8.h> */
# include <stdbool.h>
# include <stddef.h>
extern bool u8c_u8alloc(unsigned char * * const u32,size_t const sz);
diff --git a/docs/u8c_u8dec.3 b/docs/u8c_u8dec.3
index 2afe4dd..e4f7fc8 100644
--- a/docs/u8c_u8dec.3
+++ b/docs/u8c_u8dec.3
@@ -9,6 +9,7 @@ u8c_u8dec - UTF-8 decode - Convert an UTF-8 string to UTF-32.
.IP
.nf
\f[C]
+/* # include <u8c/u8.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u8enc.3 b/docs/u8c_u8enc.3
index 64feaf1..d6fc549 100644
--- a/docs/u8c_u8enc.3
+++ b/docs/u8c_u8enc.3
@@ -9,6 +9,7 @@ u8c_u8enc - UTF-8 encode - Convert an UTF-32 string to UTF-8.
.IP
.nf
\f[C]
+/* # include <u8c/u8.h> */
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
diff --git a/docs/u8c_u8free.3 b/docs/u8c_u8free.3
index 8c2c0ba..da10a20 100644
--- a/docs/u8c_u8free.3
+++ b/docs/u8c_u8free.3
@@ -1,11 +1,12 @@
.TH "u8c_u8free" "3" "" "u8c" "u8c API Manual"
.SH NAME
.PP
-u8c_u8free - UTF-8 free - Free UTF-8 string and set it to \f[B]NULL\f[R].
+u8c_u8free - UTF-8 free - Deallocate UTF-8 string and set it to \f[B]NULL\f[R].
.SH DECLARATION
.PP
.nf
\f[C]
+/* # include <u8c/u8.h> */
# include <stdbool.h>
extern bool u8c_u8free(unsigned char const * * const u8);
\f[R]
diff --git a/docs/u8c_unimax.3 b/docs/u8c_unimax.3
index 7b35dc9..8f6165d 100644
--- a/docs/u8c_unimax.3
+++ b/docs/u8c_unimax.3
@@ -6,6 +6,7 @@ u8c_unimax - Unicode maximum - Maximum valid Unicode codepoint.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdint.h>
# include <uchar.h>
# define u8c_unimax ((char32_t)UINT32_C(0x10FFFF))
diff --git a/docs/u8c_ver.3 b/docs/u8c_ver.3
index 7c2ea39..388b5cb 100644
--- a/docs/u8c_ver.3
+++ b/docs/u8c_ver.3
@@ -6,6 +6,7 @@ u8c_ver - Version - Version of the u8c API.
.PP
.nf
\f[C]
+/* # include <u8c/main.h> */
# include <stdint.h>
# define u8c_ver (UINT64_C(/* version */))
\f[R]
diff --git a/docs/u8c_vfmt.3 b/docs/u8c_vfmt.3
index 9b2f626..0eff93a 100644
--- a/docs/u8c_vfmt.3
+++ b/docs/u8c_vfmt.3
@@ -6,6 +6,7 @@ u8c_vfmt - Variadic format - Format UTF-32 string.
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdarg.h>
# include <stdbool.h>
# include <stddef.h>
diff --git a/docs/u8c_vprint.3 b/docs/u8c_vprint.3
index 5db1cee..e3d58f6 100644
--- a/docs/u8c_vprint.3
+++ b/docs/u8c_vprint.3
@@ -6,6 +6,7 @@ u8c_vprint - Variadic print - Format UTF-32 and print it to file.
.PP
.nf
\f[C]
+/* # include <u8c/fmt.h> */
# include <stdarg.h>
# include <stdbool.h>
# include <stdio.h>