summaryrefslogtreecommitdiffstats
path: root/man1/iconv.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/iconv.1')
-rw-r--r--man1/iconv.148
1 files changed, 31 insertions, 17 deletions
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