From a4460f6d9453bbd7e584937686449cef3e19f052 Mon Sep 17 00:00:00 2001 From: Leo Tenenbaum Date: Mon, 20 Aug 2018 20:34:57 -0400 Subject: Initial commit --- gtk+-mingw/share/doc/libiconv/iconv.1.html | 206 +++++++++++++ gtk+-mingw/share/doc/libiconv/iconv.3.html | 207 ++++++++++++++ gtk+-mingw/share/doc/libiconv/iconv_close.3.html | 90 ++++++ gtk+-mingw/share/doc/libiconv/iconv_open.3.html | 318 +++++++++++++++++++++ .../share/doc/libiconv/iconv_open_into.3.html | 120 ++++++++ gtk+-mingw/share/doc/libiconv/iconvctl.3.html | 189 ++++++++++++ 6 files changed, 1130 insertions(+) create mode 100644 gtk+-mingw/share/doc/libiconv/iconv.1.html create mode 100644 gtk+-mingw/share/doc/libiconv/iconv.3.html create mode 100644 gtk+-mingw/share/doc/libiconv/iconv_close.3.html create mode 100644 gtk+-mingw/share/doc/libiconv/iconv_open.3.html create mode 100644 gtk+-mingw/share/doc/libiconv/iconv_open_into.3.html create mode 100644 gtk+-mingw/share/doc/libiconv/iconvctl.3.html (limited to 'gtk+-mingw/share/doc/libiconv') diff --git a/gtk+-mingw/share/doc/libiconv/iconv.1.html b/gtk+-mingw/share/doc/libiconv/iconv.1.html new file mode 100644 index 0000000..dfeb0fc --- /dev/null +++ b/gtk+-mingw/share/doc/libiconv/iconv.1.html @@ -0,0 +1,206 @@ + + + + + + + + + +ICONV + + + + +

ICONV

+ +NAME
+SYNOPSIS
+DESCRIPTION
+EXAMPLES
+CONFORMING TO
+SEE ALSO
+ +

+ + +

NAME + +

+ + +

iconv − +character set conversion

+ +

SYNOPSIS + +

+ + +

iconv +[OPTION...] [−f encoding] +[−t encoding] [inputfile ...] +
+iconv −l

+ +

DESCRIPTION + +

+ + +

The +iconv program converts text from one encoding to +another encoding. More precisely, it converts from +the encoding given for the −f option to +the encoding given for the −t option. Either of +these encodings defaults to the encoding of the current +locale. All the inputfiles are read and converted in +turn; if no inputfile is given, the standard input is +used. The converted text is printed to standard output.

+ +

The encodings +permitted are system dependent. For the libiconv +implementation, they are listed in the iconv_open(3) manual +page.

+ +

Options +controlling the input and output format:
+−f encoding, +−−from−code=encoding

+ +

Specifies the encoding of the +input.

+ +

−t +encoding, +−−to−code=encoding

+ +

Specifies the encoding of the +output.

+ +

Options +controlling conversion problems:

+ + + + + + + +

+ + +

−c

+ + +

When this option is given, characters that cannot be +converted are silently discarded, instead of leading to a +conversion error.

+ + +

−−unicode−subst=formatstring

+ +

When this option is given, +Unicode characters that cannot be represented in the target +encoding are replaced with a placeholder string that is +constructed from the given formatstring, applied to +the Unicode code point. The formatstring must be a +format string in the same format as for the printf +command or the printf() function, taking either no +argument or exactly one unsigned integer argument.

+ + +

−−byte−subst=formatstring

+ +

When this option is given, +bytes in the input that are not valid in the source encoding +are replaced with a placeholder string that is constructed +from the given formatstring, applied to the +byte’s value. The formatstring must be a format +string in the same format as for the printf command +or the printf() function, taking either no argument +or exactly one unsigned integer argument.

+ + +

−−widechar−subst=formatstring

+ +

When this option is given, wide +characters in the input that are not valid in the source +encoding are replaced with a placeholder string that is +constructed from the given formatstring, applied to +the byte’s value. The formatstring must be a +format string in the same format as for the printf +command or the printf() function, taking either no +argument or exactly one unsigned integer argument.

+ +

Options +controlling error output:
+−s, −−silent

+ +

When this option is given, +error messages about invalid or unconvertible characters are +omitted, but the actual converted text is unaffected.

+ +

The iconv +−l or iconv −−list command +lists the names of the 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.

+ +

EXAMPLES + +

+ + +

iconv +−f ISO−8859−1 −t UTF−8

+ +

converts input from the old +West-European encoding ISO−8859−1 to +Unicode.

+ +

iconv +−f KOI8−R +−−byte−subst="<0x%x>"
+ +−−unicode−subst="<U+%04X>"

+ +

converts input from the old +Russian encoding KOI8−R to the locale encoding, +substituting an angle bracket notation with hexadecimal +numbers for invalid bytes and for valid but unconvertible +characters.

+ +

iconv +−−list

+ +

lists the supported +encodings.

+ +

CONFORMING TO + +

+ + +

POSIX:2001

+ +

ICONV

+ +NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +

+ + +

NAME + +

+ + +

iconv − +perform character set conversion

+ +

SYNOPSIS + +

+ + +

#include +<iconv.h>

+ +

size_t iconv +(iconv_t cd,
+const char* * inbuf, size_t * +inbytesleft,
+char* * outbuf, size_t * +outbytesleft);

+ +

DESCRIPTION + +

+ + +

The argument +cd must be a conversion descriptor created using the +function iconv_open.

+ +

The main case +is when inbuf is not NULL and *inbuf is not +NULL. In this case, the iconv function converts the +multibyte sequence starting at *inbuf to a multibyte +sequence starting at *outbuf. At most +*inbytesleft bytes, starting at *inbuf, will +be read. At most *outbytesleft bytes, starting at +*outbuf, will be written.

+ +

The +iconv function converts one multibyte character at a +time, and for each character conversion it increments +*inbuf and decrements *inbytesleft by the +number of converted input bytes, it increments +*outbuf and decrements *outbytesleft by the +number of converted output bytes, and it updates the +conversion state contained in cd. If the character +encoding of the input is stateful, the iconv 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 shift sequence. The conversion +can stop for four reasons:

+ +

1. An invalid +multibyte sequence is encountered in the input. In this case +it sets errno to EILSEQ and returns +(size_t)(−1). *inbuf is left pointing to the +beginning of the invalid multibyte sequence.

+ +

2. The input +byte sequence has been entirely converted, i.e. +*inbytesleft has gone down to 0. In this case +iconv returns the number of non-reversible +conversions performed during this call.

+ +

3. An +incomplete multibyte sequence is encountered in the input, +and the input byte sequence terminates after it. In this +case it sets errno to EINVAL and returns +(size_t)(−1). *inbuf is left pointing to the +beginning of the incomplete multibyte sequence.

+ +

4. The output +buffer has no more room for the next converted character. In +this case it sets errno to E2BIG and returns +(size_t)(−1).

+ +

A different +case is when inbuf is NULL or *inbuf is NULL, +but outbuf is not NULL and *outbuf is not +NULL. In this case, the iconv function attempts to +set cd’s conversion state to the initial state +and store a corresponding shift sequence at *outbuf. +At most *outbytesleft bytes, starting at +*outbuf, will be written. If the output buffer has no +more room for this reset sequence, it sets errno to +E2BIG and returns (size_t)(−1). Otherwise it +increments *outbuf and decrements +*outbytesleft by the number of bytes written.

+ +

A third case is +when inbuf is NULL or *inbuf is NULL, and +outbuf is NULL or *outbuf is NULL. In this +case, the iconv function sets cd’s +conversion state to the initial state.

+ +

RETURN VALUE + +

+ + +

The +iconv function returns the number of characters +converted in a non-reversible way during this call; +reversible conversions are not counted. In case of error, it +sets errno and returns (size_t)(−1).

+ +

ERRORS + +

+ + +

The following +errors can occur, among others:

+ + + + + + + + + + + + + + + + + +

	+ + + E2BIG		+ + + There is not sufficient room at *outbuf.
	+ + + EILSEQ		+ + + An invalid multibyte sequence has been encountered in +the input.
	+ + + EINVAL		+ + + An incomplete multibyte sequence has been encountered in +the input.

+ +

CONFORMING TO + +

+ + +

POSIX:2001

+ +

ICONV_CLOSE

+ +NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+CONFORMING TO
+SEE ALSO
+ +

+ + +

NAME + +

+ + +

iconv_close +− deallocate descriptor for character set +conversion

+ +

SYNOPSIS + +

+ + +

#include +<iconv.h>

+ +

int +iconv_close (iconv_t cd);

+ +

DESCRIPTION + +

+ + +

The +iconv_close function deallocates a conversion +descriptor cd previously allocated using +iconv_open.

+ +

RETURN VALUE + +

+ + +

When +successful, the iconv_close function returns 0. In +case of error, it sets errno and returns +−1.

+ +

CONFORMING TO + +

+ + +

POSIX:2001

+ +

ICONV_OPEN

+ +NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +

+ + +

NAME + +

+ + +

iconv_open +− allocate descriptor for character set conversion

+ +

SYNOPSIS + +

+ + +

#include +<iconv.h>

+ +

iconv_t +iconv_open (const char* tocode, const +char* fromcode);

+ +

DESCRIPTION + +

+ + +

The +iconv_open function allocates a conversion descriptor +suitable for converting byte sequences from character +encoding fromcode to character encoding +tocode.

+ +

The values +permitted for fromcode and tocode and the +supported combinations are system dependent. For the +libiconv library, the following encodings are supported, in +all combinations.
+European languages

+ +

ASCII, +ISO−8859−{1,2,3,4,5,7,9,10,13,14,15,16}, +KOI8−R, KOI8−U, KOI8−RU, +CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131}, +Mac{Roman,CentralEurope,Iceland,Croatian,Romania}, +Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh

+ +

Semitic languages

+ +

ISO−8859−{6,8}, +CP{1255,1256}, CP862, Mac{Hebrew,Arabic}

+ +

Japanese

+ +

EUC−JP, SHIFT_JIS, CP932, +ISO−2022−JP, ISO−2022−JP−2, +ISO−2022−JP−1

+ +

Chinese

+ +

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

+ + + + + + + + +

+ + +

Korean

+ + +

EUC−KR, CP949, ISO−2022−KR, JOHAB

+ +

Armenian

+ +

ARMSCII−8

+ +

Georgian

+ +

Georgian−Academy, +Georgian−PS

+ + + + + + + + + + + + + + + + + + + + +

+ + + Tajik	+ + + KOI8−T	+
+ + + Kazakh	+ + + PT154, RK1048	+
+ + + Thai	+ + + TIS−620, CP874, MacThai	+

+ +

Laotian

+ +

MuleLao−1, CP1133

+ +

Vietnamese

+ +

VISCII, TCVN, CP1258

+ +

Platform specifics

+ +

HP−ROMAN8, NEXTSTEP

+ +

Full Unicode

+ +

UTF−8
+UCS−2, UCS−2BE, UCS−2LE
+UCS−4, UCS−4BE, UCS−4LE
+UTF−16, UTF−16BE, UTF−16LE
+UTF−32, UTF−32BE, UTF−32LE
+UTF−7
+C99, JAVA

+ +

Full Unicode, in terms of +uint16_t or uint32_t

+ +

(with machine dependent +endianness and alignment)
+UCS−2−INTERNAL, UCS−4−INTERNAL

+ +

Locale dependent, in terms of +char or wchar_t

+ +

(with machine dependent +endianness and alignment, and with semantics depending on +the OS and the current LC_CTYPE locale facet)
+char, wchar_t

+ +

When configured +with the option +−−enable−extra−encodings, it +also provides support for a few extra encodings:
+European languages

+ + +

CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}

+ +

Semitic languages

+ +

CP864

+ +

Japanese

+ +

EUC−JISX0213, +Shift_JISX0213, ISO−2022−JP−3

+ +

Chinese

+ +

BIG5−2003 +(experimental)

+ +

Turkmen

+ +

TDS565

+ +

Platform specifics

+ +

ATARIST, +RISCOS−LATIN1

+ +

The empty +encoding name "" is equivalent to +"char": it denotes the locale dependent character +encoding.

+ +

When the string +"//TRANSLIT" is appended to 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 characters +that look similar to the original character.

+ +

When the string +"//IGNORE" is appended to tocode, +characters that cannot be represented in the target +character set will be silently discarded.

+ +

The resulting +conversion descriptor can be used with iconv any +number of times. It remains valid until deallocated using +iconv_close.

+ +

A conversion +descriptor contains a conversion state. After creation using +iconv_open, the state is in the initial state. Using +iconv modifies the descriptor’s conversion +state. (This implies that a conversion descriptor can not be +used in multiple threads simultaneously.) To bring the state +back to the initial state, use iconv with NULL as +inbuf argument.

+ +

RETURN VALUE + +

+ + +

The +iconv_open function returns a freshly allocated +conversion descriptor. In case of error, it sets +errno and returns (iconv_t)(−1).

+ +

ERRORS + +

+ + +

The following +error can occur, among others:

+ + + + + + + +

+ + +

EINVAL

+ + +

The conversion from fromcode to tocode is +not supported by the implementation.

+ +

CONFORMING TO + +

+ + +

POSIX:2001

+ +

ICONV_OPEN_INTO

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +

+ + + +

NAME

+ + +

+iconv_open_into - initialize descriptor for character set conversion

+ +

SYNOPSIS

+ + + +

#include <iconv.h>
+
+int iconv_open_into (const char* tocode, const char* fromcode,
+                     iconv_allocation_t* resultp);
+

+ +

DESCRIPTION

+ + + +

+The iconv_open_into function initializes a conversion +descriptor suitable for converting byte sequences from +character encoding fromcode to character encoding +tocode. The conversion descriptor is stored in the +memory pointed to by resultp.

+ + + +

+The values permitted for fromcode and tocode +are the same as for the function +iconv_open.

+ + + +

+After a successful return from this function, resultp +can be be used as an iconv_t object with the +iconv function.

+ +

RETURN VALUE

+ + + +

+The iconv_open_into function fills +*resultp and returns 0 if it succeeds. In case +of error, it sets errno and returns -1.

+ +

ERRORS

+ + + +

+The following error can occur, among others:

+ + + +

+EINVAL

+ + + +

+The conversion from fromcode to tocode is not +supported by the implementation.

+ +

CONFORMING TO

+ + + +

+This function is implemented only in GNU libiconv and not in +other iconv implementations. It is not backed by a +standard. You can test for its presence through +(_LIBICONV_VERSION >= 0x010D).

+ +

ICONVCTL

+NAME
+SYNOPSIS
+DESCRIPTION
+REQUEST VALUES
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +

+ + + +

NAME

+ + +

+iconvctl - control iconv behavior

+ +

SYNOPSIS

+ + + +

#include <iconv.h>
+
+int iconvctl (iconv_t cd , int request, void * argument);
+

+ +

DESCRIPTION

+ + + +

+The argument cd must be a conversion descriptor +created using the function iconv_open.

+ + + +

+iconvctl queries or adjusts the behavior of the +iconv function, when invoked with the specified +conversion descriptor, depending on the request +value.

+ +

REQUEST VALUES

+ + + +

+The following are permissible values for the request +parameter.

+ + + +

+ICONV_TRIVIALP

+ + + +

+argument should be an int * which will receive +1 if the conversion is trivial, or 0 otherwise.

+ + + +

+ICONV_GET_TRANSLITERATE

+ + + +

+argument should be an int * which will receive +1 if transliteration is enabled in the conversion, or 0 +otherwise.

+ + + +

+ICONV_SET_TRANSLITERATE

+ + + +

+argument should be a const int *, pointing to +an int value. A non-zero value is used to enable +transliteration in the conversion. A zero value disables +it.

+ + + +

+ICONV_GET_DISCARD_ILSEQ

+ + + +

+argument should be an int * which will receive +1 if "illegal sequence discard and continue" is +enabled in the conversion, or 0 otherwise.

+ + + +

+ICONV_SET_DISCARD_ILSEQ

+ + + +

+argument should be a const int *, pointing to +an int value. A non-zero value is used to enable +"illegal sequence discard and continue" in the +conversion. A zero value disables it.

+ +

RETURN VALUE

+ + + +

+The iconvctl function returns 0 if it succeeds. In +case of error, it sets errno and returns +-1.

+ +

ERRORS

+ + + +

+The following errors can occur, among others:

+ + + +

+EINVAL

+ + + +

+The request is invalid.

+ +

CONFORMING TO

+ + + +

+ +

ICONV

NAME + +

SYNOPSIS + +

DESCRIPTION + +

EXAMPLES + +

CONFORMING TO + +

SEE ALSO + +

ICONV

NAME + +

SYNOPSIS + +

DESCRIPTION + +

RETURN VALUE + +

ERRORS + +

CONFORMING TO + +

SEE ALSO + +

ICONV_CLOSE

NAME + +

SYNOPSIS + +

DESCRIPTION + +

RETURN VALUE + +

CONFORMING TO + +

SEE ALSO + +

ICONV_OPEN

NAME + +

SYNOPSIS + +

DESCRIPTION + +

RETURN VALUE + +

ERRORS + +

CONFORMING TO + +

SEE ALSO + +

ICONV_OPEN_INTO

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUE

ERRORS

CONFORMING TO

SEE ALSO

ICONVCTL

NAME

SYNOPSIS

DESCRIPTION

REQUEST VALUES

RETURN VALUE

ERRORS

CONFORMING TO

SEE ALSO