Skip to content

Commit

Permalink
doc/recode.texi: improve iconv documentation
Browse files Browse the repository at this point in the history
Explain the implementation of --strict with iconv better.

Remove some documentation left over from earlier experiments.
  • Loading branch information
rrthomas committed Feb 17, 2022
1 parent 62b996d commit 2a93396
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions doc/recode.texi
Original file line number Diff line number Diff line change
Expand Up @@ -2956,8 +2956,12 @@ an external @code{iconv} library, as they likely share many charsets.
We discuss, here, the issues related to this duplication, and other
peculiarities specific to the @code{iconv} library.

The @code{strict_mapping} request option is implemented by adding
@code{iconv} option @code{//IGNORE} to the @samp{after} encoding.
The @code{RECODE_STRICT_MAPPING_FLAG} option, corresponding to the
@samp{--strict} flag, is implemented by adding @code{iconv} option
@code{//IGNORE} to the @samp{after} encoding. This has the side effect
that untranslatable input is only signalled at the end of the
conversion, whereas with Recode's built-in conversion routines the error
will be signalled immediately.

If the string @code{-translit} is appended to the @var{after} encoding,
characters being converted are transliterated when needed and possible.
Expand All @@ -2968,9 +2972,6 @@ set and cannot be transliterated are replaced with a question mark (?)
in the output. This corresponds to the @code{iconv} option
@code{//TRANSLIT}.

The two suffixes can be combined using the suffix
@code{-translit-ignore}; for example, @code{iso-8859-1-translit-ignore}.

To check whether @code{iconv} is used for a particular conversion,
just use the @samp{-v} or @samp{--verbose} option, @pxref{Recoding}, and
check whether @samp{:iconv:} appears as an intermediate charset.
Expand Down

0 comments on commit 2a93396

Please sign in to comment.