LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / iconv_open.3

diff --git a/original/man3/iconv_open.3 b/original/man3/iconv_open.3
index 9d4ad42..516049d 100644 (file)
--- a/original/man3/iconv_open.3
+++ b/original/man3/iconv_open.3
@@ -1,9 +1,11 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
@@ -26,26 +28,39 @@ iconv_open \- allocate descriptor for character set conversion
 The
 .BR iconv_open ()
 function allocates a conversion descriptor suitable
-for converting byte sequences from character encoding \fIfromcode\fP to
-character encoding \fItocode\fP.
+for converting byte sequences from character encoding
+.I fromcode
+to
+character encoding
+.IR tocode .
 .PP
-The values permitted for \fIfromcode\fP and \fItocode\fP and the supported
+The values permitted for
+.IR fromcode
+and
+.I tocode
+and the supported
 combinations are system-dependent.
 For the GNU C library, the permitted
-values are listed by the \fBiconv \-\-list\fP command, and all combinations
+values are listed by the
+.I "iconv \-\-list"
+command, and all combinations
 of the listed values are supported.
 Furthermore the GNU C library and the
 GNU libiconv library support the following two suffixes:
 .TP
 //TRANSLIT
-When the string "//TRANSLIT" is appended to \fItocode\fP, transliteration
+When the string "//TRANSLIT" is appended to
+.IR tocode ,
+transliteration
 is activated.
 This means that when a character cannot be represented in the
 target character set, it can be approximated through one or several
 similarly looking characters.
 .TP
 //IGNORE
-When the string "//IGNORE" is appended to \fItocode\fP, characters that
+When the string "//IGNORE" is appended to
+.IR tocode ,
+characters that
 cannot be represented in the target character set will be silently discarded.
 .PP
 The resulting conversion descriptor can be used with
@@ -65,25 +80,42 @@ modifies the descriptor's conversion state.
 descriptor can not be used in multiple threads simultaneously.)
 To bring the state back to the initial state, use
 .BR iconv (3)
-with NULL as \fIinbuf\fP argument.
-.SH "RETURN VALUE"
+with NULL as
+.I inbuf
+argument.
+.SH RETURN VALUE
 The
 .BR iconv_open ()
 function returns a freshly allocated conversion
 descriptor.
-In case of error, it sets \fIerrno\fP and returns
+In case of error, it sets
+.I errno
+and returns
 .IR (iconv_t)\ \-1 .
 .SH ERRORS
 The following error can occur, among others:
 .TP
 .B EINVAL
-The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
+The conversion from
+.IR fromcode
+to
+.I tocode
+is not supported by the
 implementation.
 .SH VERSIONS
 This function is available in glibc since version 2.1.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 UNIX98, POSIX.1-2001.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR iconv (1),
 .BR iconv (3),
 .BR iconv_close (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.