[bug-gnu-libiconv] Several iconvctl options missing from man page

[amores perros]

(PS: I just noticed that my name is listed
with copyright on the man page; I'm quite
willing to transfer any and all copyrights
I may have in iconv code and documentation
to Bruno Haible, if he would like.)

There are two new, apparently legal, options
to iconvctl which are not listed in its man page.

libiconv-1.11/man/iconvctl.3
libiconv-1.11/man/iconvctl.3.html

The two new options (from libiconv-1.11/lib/iconv.c) are

ICONV_SET_HOOKS

ICONV_SET_FALLBACKS



I realize this bug report isn't nearly as useful
as would be patch to the man page
to actually describe these, but I'm not familiar
with them. Looking at the types and the headers,
I might hazard this:

-------------------------


ICONV_SET_HOOKS

The client may use this option to specify hooks (callbacks)
so that client code can run after every successful conversion
to either a unicode character or a wide character; each of these
cases involves a different hook, and both are specified in
the structure whose address is passed in to iconvctl with
ICONV_SET_HOOKS. Note that individual callback functions
may be left null; iconv only calls through non-null callbacks.
See iconv.h for structure and callback function declarations.

ICONV_SET_FALLBACKS

The client may use this option to specify client fallback
converters. When iconv finds a sequence it cannot convert,
it will call an appropriate client callback if registered.
The callback is expected to examine the input buffer passed
it, and convert as much as it can; the client is given
a "write_replacement" function with which it may write
conversions back to iconv.

There are four types of callbacks for four different
directions of conversion (unicode to multibyte and reverse,
widechar to multibyte and reverse). Any subset of these
may be left null in the client provided callback structure;
iconv only calls through non-null callbacks.
See iconv.h for structure and callback function declarations.

_________________________________________________________________
Get a FREE Web site, company branded e-mail and more from Microsoft Office 
Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/