- * \section Locales and character encodings
- *
- * wimlib 1.3.0 is able to better handle alternate character encodings than
- * previous versions. Functions are explictly noted as taking ::wimlib_mbchar
- * strings, which are encoded in the locale-dependent multibyte encoding (e.g.
- * ASCII, ISO-8859-1, or UTF-8), or ::wimlib_utf8char strings, which are
- * encoded in UTF-8. Generally, filenames and paths are in the locale-dependent
- * multibyte encoding, while other types of data must be provided in UTF-8.
- * Please see the man page for 'imagex' for more information.
+ * \section encodings Locales and character encodings
+ *
+ * wimlib 1.3.0 has improved handling of different character encodings compared
+ * to previous versions. Functions are explictly noted as taking
+ * ::wimlib_mbchar strings, which are encoded in the locale-dependent multibyte
+ * encoding (e.g. ASCII, ISO-8859-1, or UTF-8), or ::wimlib_utf8char strings,
+ * which are encoded in UTF-8. Generally, filenames and paths are in the
+ * locale-dependent multibyte encoding, while other types of data must be
+ * provided in UTF-8. Please see the man page for @b imagex for more
+ * information. However, I strongly recommend that you use UTF-8 for your
+ * locale's encoding so that ::wimlib_mbchar strings will be encoded the same
+ * way as ::wimlib_utf8char strings.