aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFlorian Weimer <fweimer@redhat.com>2025-06-05 14:46:14 +0200
committerAlejandro Colomar <alx@kernel.org>2025-06-11 13:56:51 +0200
commitd1324c82d0fedb45678d7c74cda2200f14f75a72 (patch)
treed2a8b9d7262d9db312b1c56966e431f5bd6ab666
parent9fbe8215606e577f66aea30b1106815e7143bdce (diff)
downloadman-pages-d1324c82d0fedb45678d7c74cda2200f14f75a72.tar.gz
man/man1/iconv.1: Mention that -c does not change exit status
And that input decoding failures are treated as errors. Exiting with status 0 is a POSIX conformance issue that was fixed in glibc 2.41. Signed-off-by: Florian Weimer <fweimer@redhat.com> Message-ID: <87msamxso9.fsf@oldenburg.str.redhat.com> Reviewed-by: Carlos O'Donell <carlos@redhat.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man1/iconv.17
1 files changed, 6 insertions, 1 deletions
diff --git a/man/man1/iconv.1 b/man/man1/iconv.1
index 2c8ae0d29c..fba5a4a766 100644
--- a/man/man1/iconv.1
+++ b/man/man1/iconv.1
@@ -55,6 +55,8 @@ is appended to
.IR to-encoding ,
characters that cannot be converted are discarded and an error is
printed after conversion.
+(Characters that cannot be decoded are treated as an error
+with or without this flag.)
.IP
If the string
.B //TRANSLIT
@@ -73,8 +75,11 @@ transliterated are replaced with a question mark (?) in the output.
List all known character set encodings.
.TP
.B \-c
-Silently discard characters that cannot be converted instead of
+Discard characters that cannot be converted instead of
terminating when encountering such characters.
+.\" glibc commit 6cbf845fcdc76131d0e674cee454fe738b69c69d
+POSIX requires that this option does not change
+the exit status of the program.
.TP
.BI \-\-output= outputfile
.TQ