Regenerated with autoconf-2.52.
[libiconv.git] / man / iconv.1
blobdf391f90648e9cb948dc98acd4f7546e116d8203
1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2 .\"
3 .\" This is free documentation; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License as
5 .\" published by the Free Software Foundation; either version 2 of
6 .\" the License, or (at your option) any later version.
7 .\"
8 .\" References consulted:
9 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
10 .\"
11 .TH ICONV 1  "February 20, 2001" "GNU" "Linux Programmer's Manual"
12 .SH NAME
13 iconv \- character set conversion
14 .SH SYNOPSIS
15 iconv [\fB-f\fP \fIencoding\fP] [\fB-t\fP \fIencoding\fP] [\fIinputfile\fP ...]
16 .SH DESCRIPTION
17 The \fBiconv\fP program converts text from one encoding to another encoding.
18 More precisely, it converts \fBfrom\fP the encoding given for the \fB-f\fP
19 option \fBto\fP the encoding given for the \fB-t\fP option. Either of these
20 encodings defaults to the encoding of the current locale. All the
21 \fIinputfile\fPs are read and converted in turn; if no \fIinputfile\fP is
22 given, the standard input is used. The converted text is printed to standard
23 output.
24 .PP
25 The encodings permitted are system dependent. For the libiconv implementation,
26 they are listed in the iconv_open(3) manual page.
27 .SH "SEE ALSO"
28 .BR iconv_open "(3), " locale (7)