From 3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:07 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man1/iconv.1 | 48 +++++++++++++++++++++++++++++++----------------- 1 file changed, 31 insertions(+), 17 deletions(-) (limited to 'man1/iconv.1') diff --git a/man1/iconv.1 b/man1/iconv.1 index 39fb6ba..d1e10f8 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH iconv 1 2023-03-30 "Linux man-pages 6.05.01" +.TH iconv 1 2024-01-28 "Linux man-pages 6.7" .SH NAME iconv \- convert text from one character encoding to another .SH SYNOPSIS @@ -22,7 +22,7 @@ reads from standard input. If no output file is given, .B iconv writes to standard output. -.PP +.P If no .I from-encoding is given, the default is derived @@ -34,12 +34,16 @@ from the current locale's character encoding. .SH OPTIONS .TP -.BI \-f " from-encoding" "\fR, \fP\-\-from\-code=" from-encoding +.BI \-\-from\-code= from-encoding +.TQ +.BI \-f\~ from-encoding Use .I from-encoding for input characters. .TP -.BI \-t " to-encoding" "\fR, \fP\-\-to\-code=" to-encoding +.BI \-\-to\-code= to-encoding +.TQ +.BI \-t\~ to-encoding Use .I to-encoding for output characters. @@ -62,32 +66,42 @@ looking characters. Characters that are outside of the target character set and cannot be transliterated are replaced with a question mark (?) in the output. .TP -.BR \-l ", " \-\-list +.B \-\-list +.TQ +.B \-l List all known character set encodings. .TP -.B "\-c" +.B \-c Silently discard characters that cannot be converted instead of terminating when encountering such characters. .TP -.BI \-o " outputfile" "\fR, \fP\-\-output=" outputfile +.BI \-\-output= outputfile +.TQ +.BI \-o\~ outputfile Use .I outputfile for output. .TP -.BR \-s ", " \-\-silent +.B \-\-silent +.TQ +.B \-s This option is ignored; it is provided only for compatibility. .TP -.B "\-\-verbose" +.B \-\-verbose Print progress information on standard error when processing multiple files. .TP -.BR \-? ", " \-\-help +.B \-\-help +.TQ +.B \-? Print a usage summary and exit. .TP -.B "\-\-usage" +.B \-\-usage Print a short usage summary and exit. .TP -.BR \-V ", " \-\-version +.B \-\-version +.TQ +.B \-V Print the version number, license, and disclaimer of warranty for .BR iconv . .SH EXIT STATUS @@ -155,7 +169,7 @@ Usual system default gconv module configuration file. .TP .I /usr/lib/gconv/gconv\-modules.cache Usual system gconv module configuration cache. -.PP +.P Depending on the architecture, the above files may instead be located at directories with the path prefix .IR /usr/lib64 . @@ -164,17 +178,17 @@ POSIX.1-2008. .SH HISTORY POSIX.1-2001. .SH EXAMPLES -Convert text from the ISO 8859-15 character encoding to UTF-8: -.PP +Convert text from the ISO/IEC\~8859-15 character encoding to UTF-8: +.P .in +4n .EX $ \fBiconv \-f ISO\-8859\-15 \-t UTF\-8 < input.txt > output.txt\fP .EE .in -.PP +.P The next example converts from UTF-8 to ASCII, transliterating when possible: -.PP +.P .in +4n .EX $ \fBecho abc ß α € àḃç | iconv \-f UTF\-8 \-t ASCII//TRANSLIT\fP -- cgit v1.2.3