@cpp.js/package-iconv 1.0.0-beta.20 → 1.0.0-beta.21

package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv.3.html

@@ -25,6 +25,7 @@
 <a href="#RETURN VALUE">RETURN VALUE</a><br>
 <a href="#ERRORS">ERRORS</a><br>
 <a href="#CONFORMING TO">CONFORMING TO</a><br>
+<a href="#NOTES">NOTES</a><br>
 <a href="#SEE ALSO">SEE ALSO</a><br>
 
 <hr>
@@ -83,7 +84,7 @@ encoding of the input is stateful, the <b>iconv</b> function
 can also convert a sequence of input bytes to an update of
 the conversion state without producing any output bytes;
 such input is called a <i>shift sequence</i>. The conversion
-can stop for four reasons:</p>
+can stop for five reasons:</p>
 
 <p style="margin-left:11%; margin-top: 1em">1. An invalid
 multibyte sequence is encountered in the input. In this case
@@ -91,20 +92,40 @@ it sets <b>errno</b> to <b>EILSEQ</b> and returns
 (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
 beginning of the invalid multibyte sequence.</p>
 
-<p style="margin-left:11%; margin-top: 1em">2. The input
+<p style="margin-left:11%; margin-top: 1em">2. A multibyte
+sequence is encountered that is valid but that cannot be
+translated to the character encoding of the output. This
+condition depends on the implementation and on the
+conversion descriptor. In the GNU C library and GNU
+libiconv, if <i>cd</i> was created without the suffix
+<b>//TRANSLIT</b> or <b>//IGNORE</b> or
+<b>//NON_IDENTICAL_DISCARD</b>, the conversion is strict:
+lossy conversions produce this condition. If the suffix
+<b>//TRANSLIT</b> was specified, transliteration can avoid
+this condition in some cases. In the musl C library, this
+condition cannot occur because a conversion to <b>'*'</b> is
+used as a fallback. In the FreeBSD, NetBSD, and Solaris
+implementations of <b>iconv</b>, this condition cannot occur
+either, because a conversion to <b>'?'</b> is used as a
+fallback. When this condition is met, the <b>iconv</b>
+function sets <b>errno</b> to <b>EILSEQ</b> and returns
+(size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
+beginning of the unconvertible multibyte sequence.</p>
+
+<p style="margin-left:11%; margin-top: 1em">3. The input
 byte sequence has been entirely converted, i.e.
 <i>*inbytesleft</i> has gone down to 0. In this case
 <b>iconv</b> returns the number of non-reversible
 conversions performed during this call.</p>
 
-<p style="margin-left:11%; margin-top: 1em">3. An
+<p style="margin-left:11%; margin-top: 1em">4. An
 incomplete multibyte sequence is encountered in the input,
 and the input byte sequence terminates after it. In this
 case it sets <b>errno</b> to <b>EINVAL</b> and returns
 (size_t)(&minus;1). <i>*inbuf</i> is left pointing to the
 beginning of the incomplete multibyte sequence.</p>
 
-<p style="margin-left:11%; margin-top: 1em">4. The output
+<p style="margin-left:11%; margin-top: 1em">5. The output
 buffer has no more room for the next converted character. In
 this case it sets <b>errno</b> to <b>E2BIG</b> and returns
 (size_t)(&minus;1).</p>
@@ -191,7 +212,35 @@ the input.</p></td></tr>
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
+
+<h2>NOTES
+<a name="NOTES"></a>
+</h2>
+
+
+<p style="margin-left:11%; margin-top: 1em">In each series
+of calls to the <b>iconv</b> function, the last should be
+one with <i>inbuf</i> or <i>*inbuf</i> equal to NULL, in
+order to complete the conversion of any partially converted
+input.</p>
+
+<p style="margin-left:11%; margin-top: 1em">Although
+<i>inbuf</i> and <i>outbuf</i> are typed as <b>const char
+**</b> and <b>char **</b>, respectively, this does not mean
+that the objects they point can be interpreted as C strings
+or as arrays of characters: the interpretation of character
+byte sequences is handled internally by the conversion
+functions. In some encodings, a zero byte may be a valid
+part of a multibyte character.</p>
+
+<p style="margin-left:11%; margin-top: 1em">The caller of
+the <b>iconv</b> function must ensure that the pointers
+passed to the function are suitable for accessing characters
+in the appropriate character set. For the encodings
+<b>UCS-2-INTERNAL</b>, <b>UCS-4-INTERNAL</b>, and
+<b>wchar_t</b>, this includes ensuring correct
+alignment.</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>
@@ -200,7 +249,7 @@ the input.</p></td></tr>
 
 
 <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3),
-<b>iconvctl</b>(3) <b>iconv_close</b>(3)</p>
+<b>iconvctl</b>(3), <b>iconv_close</b>(3)</p>
 <hr>
 </body>
 </html>

package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_close.3.html

@@ -74,7 +74,7 @@ case of error, it sets <b>errno</b> and returns
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>

package/dist/prebuilt/Emscripten-x86_64/share/doc/iconv_open.3.html

@@ -90,9 +90,10 @@ ISO-2022&minus;JP&minus;MS</p>
 <p style="margin-left:11%;">Chinese</p>
 
 <p style="margin-left:22%;">EUC&minus;CN, HZ, GBK, CP936,
-GB18030, EUC&minus;TW, BIG5, CP950, BIG5&minus;HKSCS,
-BIG5&minus;HKSCS:2004, BIG5&minus;HKSCS:2001,
-BIG5&minus;HKSCS:1999, ISO&minus;2022&minus;CN,
+GB18030, GB18030:2022, EUC&minus;TW, BIG5, CP950,
+BIG5&minus;HKSCS, BIG5&minus;HKSCS:2004,
+BIG5&minus;HKSCS:2001, BIG5&minus;HKSCS:1999,
+ISO&minus;2022&minus;CN,
 ISO&minus;2022&minus;CN&minus;EXT</p>
 
 <table width="100%" border="0" rules="none" frame="void"
@@ -273,9 +274,15 @@ it can be approximated through one or several characters
 that look similar to the original character.</p>
 
 <p style="margin-left:11%; margin-top: 1em">When the string
-&quot;//IGNORE&quot; is appended to <i>tocode</i>,
-characters that cannot be represented in the target
-character set will be silently discarded.</p>
+&quot;//IGNORE&quot; is appended to <i>tocode</i>, invalid
+multibyte sequences in the input and characters that cannot
+be represented in the target character set will be silently
+discarded.</p>
+
+<p style="margin-left:11%; margin-top: 1em">When the string
+&quot;//NON_IDENTICAL_DISCARD&quot; is appended to
+<i>tocode</i>, characters that cannot be represented in the
+target character set will be silently discarded.</p>
 
 <p style="margin-left:11%; margin-top: 1em">The resulting
 conversion descriptor can be used with <b>iconv</b> any
@@ -330,7 +337,7 @@ not supported by the implementation.</p></td></tr>
 </h2>
 
 
-<p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
+<p style="margin-left:11%; margin-top: 1em">POSIX:2024</p>
 
 <h2>SEE ALSO
 <a name="SEE ALSO"></a>

package/dist/prebuilt/Emscripten-x86_64/share/doc/iconvctl.3.html

@@ -96,21 +96,95 @@ non-zero value is used to enable transliteration in the
 conversion. A zero value disables it.</p>
 
 
+<p style="margin-left:11%;"><b>ICONV_GET_DISCARD_INVALID</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>int *</b> which will receive 1 if &quot;discard invalid
+multibyte sequence from the input and continue&quot; is
+enabled in the conversion, or 0 otherwise.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_DISCARD_INVALID</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const int *</b>, pointing to an <b>int</b> value. A
+non-zero value is used to enable &quot;discard invalid
+multibyte sequence from the input and continue&quot; in the
+conversion. A zero value disables it.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_DISCARD_NON_IDENTICAL</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>int *</b> which will receive 1 if &quot;discard character
+that cannot be represented in the target character set and
+continue&quot; is enabled in the conversion, or 0
+otherwise.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_DISCARD_NON_IDENTICAL</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const int *</b>, pointing to an <b>int</b> value. A
+non-zero value is used to enable &quot;discard character
+that cannot be represented in the target character set and
+continue&quot; in the conversion. A zero value disables
+it.</p>
+
+
 <p style="margin-left:11%;"><b>ICONV_GET_DISCARD_ILSEQ</b></p>
 
 <p style="margin-left:22%;"><i>argument</i> should be an
-<b>int *</b> which will receive 1 if &quot;illegal sequence
-discard and continue&quot; is enabled in the conversion, or
-0 otherwise.</p>
+<b>int *</b> which will receive 1 if both
+&quot;discard&quot; behaviours are enabled in the
+conversion, or 0 otherwise.</p>
 
 
 <p style="margin-left:11%;"><b>ICONV_SET_DISCARD_ILSEQ</b></p>
 
 <p style="margin-left:22%;"><i>argument</i> should be a
 <b>const int *</b>, pointing to an <b>int</b> value. A
-non-zero value is used to enable &quot;illegal sequence
-discard and continue&quot; in the conversion. A zero value
-disables it.</p>
+non-zero value is used to enable both &quot;discard&quot;
+behaviours in the conversion. A zero value disables
+them.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_FROM_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>unsigned int *</b> which will receive the from-side
+(input side) surface of the conversion.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_FROM_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const unsigned int *</b>, pointing to an <b>unsigned
+int</b> value. This value is installed as the from-side
+(input side) surface of the conversion. The value is a bit
+mask. Zero denotes no surface. The value
+<b>ICONV_SURFACE_EBCDIC_ZOS_UNIX</b> has an effect on EBCDIC
+encodings: The EBCDIC newline 0x15 will get mapped to LF
+instead of NEL.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_GET_TO_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be an
+<b>unsigned int *</b> which will receive the to-side (output
+side) surface of the conversion.</p>
+
+
+<p style="margin-left:11%;"><b>ICONV_SET_TO_SURFACE</b></p>
+
+<p style="margin-left:22%;"><i>argument</i> should be a
+<b>const unsigned int *</b>, pointing to an <b>unsigned
+int</b> value. This value is installed as the to-side
+(output side) surface of the conversion. The value is a bit
+mask. Zero denotes no surface. The value
+<b>ICONV_SURFACE_EBCDIC_ZOS_UNIX</b> has an effect on EBCDIC
+encodings: LF, instead of NEL, will get mapped to the EBCDIC
+newline 0x15.</p>
 
 <h2>RETURN VALUE
 <a name="RETURN VALUE"></a>

package/dist/prebuilt/Emscripten-x86_64/share/man/man1/iconv.1

@@ -9,7 +9,7 @@
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"   POSIX 2001 draft6
 .\"
-.TH ICONV 1  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONV 1  "December 15, 2024" "GNU"
 .SH NAME
 iconv \- character set conversion
 .SH SYNOPSIS
@@ -84,6 +84,10 @@ supported encodings, in a system dependent format. For the libiconv
 implementation, the names are printed in upper case, separated by whitespace,
 and alias names of an encoding are listed on the same line as the encoding
 itself.
+.SH ENVIRONMENT
+Conversion from/to EBCDIC encodings can be modified in a specific way:
+If the environment variable \fBICONV_EBCDIC_ZOS_UNIX\fP is set to a non-empty
+value, the EBCDIC newline 0x15 will get mapped to LF instead of NEL.
 .SH EXAMPLES
 .TP
 \fBiconv \-f ISO\-8859\-1 \-t UTF\-8\fP
@@ -102,7 +106,7 @@ bytes and for valid but unconvertible characters.
 \fBiconv \-\-list\fP
 lists the supported encodings.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
 .SH "SEE ALSO"
 .BR iconv_open (3),
 .BR locale (7)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv.3

@@ -9,7 +9,7 @@
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"
-.TH ICONV 3  "September 7, 2008" "GNU" "Linux Programmer's Manual"
+.TH ICONV 3  "December 15, 2024" "GNU"
 .SH NAME
 iconv \- perform character set conversion
 .SH SYNOPSIS
@@ -38,22 +38,41 @@ output bytes, and it updates the conversion state contained in \fIcd\fP.
 If the character encoding of the input is stateful, the \fBiconv\fP function
 can also convert a sequence of input bytes to an update of the conversion state
 without producing any output bytes; such input is called a \fIshift sequence\fP.
-The conversion can stop for four reasons:
+The conversion can stop for five reasons:
 .PP
 1. An invalid multibyte sequence is encountered in the input. In this case
 it sets \fBerrno\fP to \fBEILSEQ\fP and returns (size_t)(\-1). \fI*inbuf\fP
 is left pointing to the beginning of the invalid multibyte sequence.
 .PP
-2. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
+2. A multibyte sequence is encountered that is valid but that cannot be
+translated to the character encoding of the output.
+This condition depends on the implementation and on the conversion
+descriptor.
+In the GNU C library and GNU libiconv, if \fIcd\fP was created without the
+suffix \fB//TRANSLIT\fP or \fB//IGNORE\fP or \fB//NON_IDENTICAL_DISCARD\fP,
+the conversion is strict: lossy conversions produce this condition.
+If the suffix \fB//TRANSLIT\fP was specified, transliteration can avoid this
+condition in some cases.
+In the musl C library, this condition cannot occur because a conversion to
+\fB\[aq]*\[aq]\fP is used as a fallback.
+In the FreeBSD, NetBSD, and Solaris implementations of \fBiconv\fP, this
+condition cannot occur either, because a conversion to \fB\[aq]?\[aq]\fP is
+used as a fallback.
+When this condition is met, the \fBiconv\fP function sets \fBerrno\fP to
+\fBEILSEQ\fP and returns (size_t)(\-1).
+\fI*inbuf\fP is left pointing to the beginning of the unconvertible multibyte
+sequence.
+.PP
+3. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
 has gone down to 0. In this case \fBiconv\fP returns the number of
 non-reversible conversions performed during this call.
 .PP
-3. An incomplete multibyte sequence is encountered in the input, and the
+4. An incomplete multibyte sequence is encountered in the input, and the
 input byte sequence terminates after it. In this case it sets \fBerrno\fP to
 \fBEINVAL\fP and returns (size_t)(\-1). \fI*inbuf\fP is left pointing to the
 beginning of the incomplete multibyte sequence.
 .PP
-4. The output buffer has no more room for the next converted character. In
+5. The output buffer has no more room for the next converted character. In
 this case it sets \fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1).
 .PP
 A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
@@ -85,8 +104,26 @@ An invalid multibyte sequence has been encountered in the input.
 .B EINVAL
 An incomplete multibyte sequence has been encountered in the input.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
+.SH NOTES
+In each series of calls to the \fBiconv\fP function,
+the last should be one with \fIinbuf\fP or \fI*inbuf\fP equal to NULL,
+in order to complete the conversion of any partially converted input.
+
+Although \fIinbuf\fP and \fIoutbuf\fP are typed as
+\fBconst char **\fP and \fBchar **\fP, respectively,
+this does not mean that the objects they point can be interpreted
+as C strings or as arrays of characters:
+the interpretation of character byte sequences is
+handled internally by the conversion functions.
+In some encodings, a zero byte may be a valid part of a multibyte character.
+
+The caller of the \fBiconv\fP function
+must ensure that the pointers passed to the function are suitable
+for accessing characters in the appropriate character set.
+For the encodings \fBUCS-2-INTERNAL\fP, \fBUCS-4-INTERNAL\fP, and \fBwchar_t\fP,
+this includes ensuring correct alignment.
 .SH "SEE ALSO"
 .BR iconv_open (3),
-.BR iconvctl (3)
+.BR iconvctl (3),
 .BR iconv_close (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_close.3

@@ -9,7 +9,7 @@
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"
-.TH ICONV_CLOSE 3  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONV_CLOSE 3  "December 15, 2024" "GNU"
 .SH NAME
 iconv_close \- deallocate descriptor for character set conversion
 .SH SYNOPSIS
@@ -25,7 +25,7 @@ previously allocated using \fBiconv_open\fP.
 When successful, the \fBiconv_close\fP function returns 0. In case of error,
 it sets \fBerrno\fP and returns \-1.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
 .SH "SEE ALSO"
 .BR iconv_open (3)
 .BR iconv (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open.3

@@ -9,7 +9,7 @@
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
 .\"
-.TH ICONV_OPEN 3  "January 23, 2022" "GNU" "Linux Programmer's Manual"
+.TH ICONV_OPEN 3  "December 15, 2024" "GNU"
 .SH NAME
 iconv_open \- allocate descriptor for character set conversion
 .SH SYNOPSIS
@@ -51,9 +51,9 @@ ISO-2022\-JP\-MS
 Chinese
 .nf
 .fi
-EUC\-CN, HZ, GBK, CP936, GB18030, EUC\-TW, BIG5, CP950, BIG5\-HKSCS,
-BIG5\-HKSCS:2004, BIG5\-HKSCS:2001, BIG5\-HKSCS:1999, ISO\-2022\-CN,
-ISO\-2022\-CN\-EXT
+EUC\-CN, HZ, GBK, CP936, GB18030, GB18030:2022, EUC\-TW, BIG5, CP950,
+BIG5\-HKSCS, BIG5\-HKSCS:2004, BIG5\-HKSCS:2001, BIG5\-HKSCS:1999,
+ISO\-2022\-CN, ISO\-2022\-CN\-EXT
 .TP
 Korean
 .nf
@@ -225,8 +225,14 @@ is activated. This means that when a character cannot be represented in the
 target character set, it can be approximated through one or several characters
 that look similar to the original character.
 .PP
-When the string "//IGNORE" is appended to \fItocode\fP, characters that
-cannot be represented in the target character set will be silently discarded.
+When the string "//IGNORE" is appended to \fItocode\fP,
+invalid multibyte sequences in the input and
+characters that cannot be represented in the target character set
+will be silently discarded.
+.PP
+When the string "//NON_IDENTICAL_DISCARD" is appended to \fItocode\fP,
+characters that cannot be represented in the target character set
+will be silently discarded.
 .PP
 The resulting conversion descriptor can be used with \fBiconv\fP any number
 of times. It remains valid until deallocated using \fBiconv_close\fP.
@@ -247,7 +253,7 @@ The following error can occur, among others:
 The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the
 implementation.
 .SH "CONFORMING TO"
-POSIX:2001
+POSIX:2024
 .SH "SEE ALSO"
 .BR iconv (3)
 .BR iconvctl (3)

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconv_open_into.3

@@ -8,7 +8,7 @@
 .\" References consulted:
 .\"   iconv.h
 .\"
-.TH ICONV_OPEN_INTO 3  "September 21, 2008" "GNU" "Linux Programmer's Manual"
+.TH ICONV_OPEN_INTO 3  "September 21, 2008" "GNU"
 .SH NAME
 iconv_open_into \- initialize descriptor for character set conversion
 .SH SYNOPSIS

package/dist/prebuilt/Emscripten-x86_64/share/man/man3/iconvctl.3

@@ -9,7 +9,7 @@
 .\" References consulted:
 .\"   iconv.h
 .\"
-.TH ICONVCTL 3  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONVCTL 3  "December 15, 2024" "GNU"
 .SH NAME
 iconvctl \- control iconv behavior
 .SH SYNOPSIS
@@ -41,15 +41,60 @@ transliteration is enabled in the conversion, or 0 otherwise.
 A non-zero value is used to enable transliteration in the conversion. A zero
 value disables it.
 .TP
+.B ICONV_GET_DISCARD_INVALID
+\fIargument\fP should be an \fBint *\fP which will receive 1 if "discard
+invalid multibyte sequence from the input and continue"
+is enabled in the conversion, or 0 otherwise.
+.TP
+.B ICONV_SET_DISCARD_INVALID
+\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
+A non-zero value is used to enable "discard
+invalid multibyte sequence from the input and continue"
+in the conversion. A zero value disables it.
+.TP
+.B ICONV_GET_DISCARD_NON_IDENTICAL
+\fIargument\fP should be an \fBint *\fP which will receive 1 if "discard
+character that cannot be represented in the target character set and continue"
+is enabled in the conversion, or 0 otherwise.
+.TP
+.B ICONV_SET_DISCARD_NON_IDENTICAL
+\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
+A non-zero value is used to enable "discard
+character that cannot be represented in the target character set and continue"
+in the conversion. A zero value disables it.
+.TP
 .B ICONV_GET_DISCARD_ILSEQ
-\fIargument\fP should be an \fBint *\fP which will receive 1 if 
-"illegal sequence discard and continue" is enabled in the conversion,
-or 0 otherwise.
+\fIargument\fP should be an \fBint *\fP which will receive 1 if both "discard"
+behaviours are enabled in the conversion, or 0 otherwise.
 .TP
 .B ICONV_SET_DISCARD_ILSEQ
 \fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value.
-A non-zero value is used to enable "illegal sequence discard and continue"
-in the conversion. A zero value disables it.
+A non-zero value is used to enable both "discard" behaviours in the conversion.
+A zero value disables them.
+.TP
+.B ICONV_GET_FROM_SURFACE
+\fIargument\fP should be an \fBunsigned int *\fP which will receive the
+from-side (input side) surface of the conversion.
+.TP
+.B ICONV_SET_FROM_SURFACE
+\fIargument\fP should be a \fBconst unsigned int *\fP, pointing to an
+\fBunsigned int\fP value.  This value is installed as the from-side
+(input side) surface of the conversion.  The value is a bit mask.  Zero
+denotes no surface.  The value \fBICONV_SURFACE_EBCDIC_ZOS_UNIX\fP has
+an effect on EBCDIC encodings: The EBCDIC newline 0x15 will get mapped
+to LF instead of NEL.
+.TP
+.B ICONV_GET_TO_SURFACE
+\fIargument\fP should be an \fBunsigned int *\fP which will receive the
+to-side (output side) surface of the conversion.
+.TP
+.B ICONV_SET_TO_SURFACE
+\fIargument\fP should be a \fBconst unsigned int *\fP, pointing to an
+\fBunsigned int\fP value.  This value is installed as the to-side
+(output side) surface of the conversion.  The value is a bit mask.  Zero
+denotes no surface.  The value \fBICONV_SURFACE_EBCDIC_ZOS_UNIX\fP has
+an effect on EBCDIC encodings: LF, instead of NEL, will get mapped to
+the EBCDIC newline 0x15.
 .SH "RETURN VALUE"
 The \fBiconvctl\fP function returns 0 if it succeeds. In case of error, it sets
 \fBerrno\fP and returns \-1.