[PATCH] manual: Document //TRANSLIT and //IGNORE support in iconv_open [BZ #3794]
Florian Weimer
fweimer@redhat.com
Thu Dec 18 12:45:36 GMT 2025
* Avinal Kumar:
> The //TRANSLIT and //IGNORE suffix supported by iconv_open
> was not documented in the glibc manual. This commit adds the
> documentation for the suffixes.
>
> This fixes BZ #3794.
>
> Signed-off-by: Avinal Kumar <avinal.xlvii@gmail.com>
> ---
> Refer https://man7.org/linux/man-pages/man1/iconv.1.html and
> https://www.gnu.org/savannah-checkouts/gnu/libiconv/documentation/libiconv-1.18/iconv_open.3.html
>
> manual/charset.texi | 13 +++++++++++++
> 1 file changed, 13 insertions(+)
>
> diff --git a/manual/charset.texi b/manual/charset.texi
> index 3aaa62d088..ecb437430c 100644
> --- a/manual/charset.texi
> +++ b/manual/charset.texi
> @@ -1687,6 +1687,19 @@ source and destination character set for the conversion, and if the
> implementation has the possibility to perform such a conversion, the
> function returns a handle.
>
> +The @var{tocode} argument may optionally be suffixed with
> +@code{//TRANSLIT}. When this suffix is present, transliteration is
> +enabled. With transliteration enabled, characters that cannot be
> +represented directly in the destination character set may be approximated
> +using one or more similar characters that are available in the
> +destination character set. Characters outside of the destination
> +character set and cannot be transliterated are replaced with a question
> +mark @code{?}.
> +
> +The @var{tocode} argument may also be suffixed with @code{//IGNORE}.
> +When this suffix is present, characters that cannot be converted are
> +silently discarded.
I think //TRANSLIT,IGNORE works, too. Would you please mention this as
well?
Thanks,
Florian
More information about the Libc-alpha
mailing list