Add a note on canonical UTF-8 forms in the manual

1 files changed, 10 insertions, 0 deletions

diff --git a/smenu.1 b/smenu.1
index 94e53cf..1d94753 100644
--- a/smenu.1
+++ b/smenu.1
@@ -473,6 +473,16 @@ This utility is Unicode aware and should be able to display correctly
 any Unicode character (even double-width ones) as long as the current
 encoding is \fBUTF-8\fP (\fBUTF-8\fP in the output of the \fIlocale\fP
 command).
+
+Note that smenu will not attempt to normalize words containing UTF-8 glyphs.
+Thus \fI\\u61\\ucc88\fP (\fIä\fP) will not be considered equal to
+\fI\\uc3a4\fP (canonical normalization of  \fIä\fP).
+It is nevertheless possible to use an external tool such as uconv from the
+ICU project (https://icu.unicode.org) to do this work before using smenu.
+
+For example: uconv can be used as a filter as in:
+
+\f(CBcat ... | uconv -x any-nfc | smenu\fP
 .SS Configuration
 If a file with adequate permissions and the same name as the executable
 but prefixed with a dot is present in the current directory