[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