[glibc] Update documentation of iconv [BZ #30136]

Adhemerval Zanella via Glibc-cvs <[email protected]> Tue, 23 Jun 2026 17:51:41 +0000 (GMT)
Newsgroups gmane.comp.lib.glibc.cvs
Message-ID <[email protected]>
https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=98e1e467a80b1f434e1c6d0275881e51a2eed4f2

commit 98e1e467a80b1f434e1c6d0275881e51a2eed4f2
Author: Mike FABIAN <[email protected]>
Date:   Fri Jun 19 11:45:41 2026 +0200

    Update documentation of iconv [BZ #30136]
    
    Reviewed-by: Florian Weimer <[email protected]>

Diff:
---
 manual/charset.texi | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/manual/charset.texi b/manual/charset.texi
index 10a499a4c4..09e42ebcdb 100644
--- a/manual/charset.texi
+++ b/manual/charset.texi
@@ -1842,7 +1842,8 @@ two things: either all bytes from the input buffer are consumed or
 there are some bytes at the end of the buffer that possibly can form a
 complete character but the input is incomplete.  The second reason for a
 stop is that the output buffer is full.  And the third reason is that
-the input contains invalid characters.
+the input contains invalid characters or translation to the character
+encoding of the output is not possible.
 
 In all of these cases the buffer pointers after the last successful
 conversion, for the input and output buffers, are stored in @var{inbuf} and
@@ -1866,9 +1867,11 @@ the value pointed to by @var{inbytesleft} is nonzero.
 
 @table @code
 @item EILSEQ
-The conversion stopped because of an invalid byte sequence in the input.
+The conversion stopped because of an invalid byte sequence in the
+input or because translation of the byte sequence to the character
+encoding of the output is not possible.
 After the call, @code{*@var{inbuf}} points at the first byte of the
-invalid byte sequence.
+byte sequence which caused the error.
 
 @item E2BIG
 The conversion stopped because it ran out of space in the output buffer.