* [Bug 217059] New: Please document behaviour of iconv(3) when input is untranslatable
@ 2023-02-19 10:31 bugzilla-daemon
2023-05-19 12:09 ` [Bug 217059] " bugzilla-daemon
` (2 more replies)
0 siblings, 3 replies; 4+ messages in thread
From: bugzilla-daemon @ 2023-02-19 10:31 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217059
Bug ID: 217059
Summary: Please document behaviour of iconv(3) when input is
untranslatable
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages@kernel-bugs.osdl.org
Reporter: rrt@sc3d.org
Regression: No
See https://sourceware.org/bugzilla/show_bug.cgi?id=29913
The issue is that the man page does not fully reflect the behaviour of glibc's
iconv. The man page says:
The conversion can stop for four reasons:
1. An invalid multibyte sequence is encountered in the input. In this
case, it sets errno to EILSEQ and
returns (size_t) -1. *inbuf is left pointing to the beginning of the
invalid multibyte sequence.
The phrase "An invalid multibyte sequence is encountered in the input" is
confusing, because it suggests to me (and other readers, see the bug above!)
that it refers only to the validity of the input per se (e.g. a non-UTF-8
sequence in input purporting to be UTF-8).
However, according to the original author of the man page, Bruno Haible (see
the bug above), it also refers to input that cannot be translated to the
desired output encoding; and indeed, glibc's iconv returns EILSEQ when the
input cannot be translated, even though it is valid.
Please clarify the man page to reflect this behaviour. On the one hand, it is
confusing and surprising when compared to the POSIX standard (again, for this
reader and others); on the other hand, it is useful (because it enables
untranslatable input to be detected).
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 217059] Please document behaviour of iconv(3) when input is untranslatable
2023-02-19 10:31 [Bug 217059] New: Please document behaviour of iconv(3) when input is untranslatable bugzilla-daemon
@ 2023-05-19 12:09 ` bugzilla-daemon
2023-05-19 12:09 ` bugzilla-daemon
2023-05-20 11:18 ` bugzilla-daemon
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon @ 2023-05-19 12:09 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217059
--- Comment #1 from Alejandro Colomar (alx@kernel.org) ---
Would you mind sending a patch according to the ./CONTRIBUTING file in
the repo?
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 217059] Please document behaviour of iconv(3) when input is untranslatable
2023-02-19 10:31 [Bug 217059] New: Please document behaviour of iconv(3) when input is untranslatable bugzilla-daemon
2023-05-19 12:09 ` [Bug 217059] " bugzilla-daemon
@ 2023-05-19 12:09 ` bugzilla-daemon
2023-05-20 11:18 ` bugzilla-daemon
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon @ 2023-05-19 12:09 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217059
Alejandro Colomar (alx@kernel.org) changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |NEEDINFO
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 217059] Please document behaviour of iconv(3) when input is untranslatable
2023-02-19 10:31 [Bug 217059] New: Please document behaviour of iconv(3) when input is untranslatable bugzilla-daemon
2023-05-19 12:09 ` [Bug 217059] " bugzilla-daemon
2023-05-19 12:09 ` bugzilla-daemon
@ 2023-05-20 11:18 ` bugzilla-daemon
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon @ 2023-05-20 11:18 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217059
--- Comment #2 from Reuben Thomas (rrt@sc3d.org) ---
I've sent a patch.
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-05-20 11:18 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-02-19 10:31 [Bug 217059] New: Please document behaviour of iconv(3) when input is untranslatable bugzilla-daemon
2023-05-19 12:09 ` [Bug 217059] " bugzilla-daemon
2023-05-19 12:09 ` bugzilla-daemon
2023-05-20 11:18 ` bugzilla-daemon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).