First created at:						8/6/2007
Last updated at:						8/9/2007

User land UTF-8 text preparation functions
------------------------------------------

OVERVIEW

PSARC/2007/149 introduced six new kernel functions for the support of
UTF-8 text preparations and processing such as Unicode Normalizations,
Unicode simple case conversions, UTF-8 string comparisons, and UTF-8 string
validations as specified in the Unicode Standard [2, 3].

Based on the requirements from CIFS Server and Winchester project teams,
this project proposes to make the same functions also available at the user
space and in particular at libc.

The user land interfaces proposed will provide the same functionalities
as the kernel functions have and their man pages are also pretty much the same
as shown at [1]. The only differences are man page section name changes and
such minor editorial changes to make the section 9F man pages into
the section 3C man pages. The change includes a new user land specific header
file, <sys/u8_textprep.h>.


INTERFACE STABILITY AND RELEASE BINDING

There is no notable imported interfaces. The following are the exported
interfaces:

	Interface		Stability		Reference

	u8_textprep_open(3C),	Committed		[1]
	u8_textprep_buf(3C),
	u8_textprep_close(3C),
	u8_textprep_str(3C),
	u8_strcmp(3C),
	u8_validate(3C)

	U8_* macros		Committed		[1]

	<sys/u8_textprep.h>	Committed		A header file that has
							function prototypes
							and macros.

The project team asks for Micro/Patch release binding.


REFERENCES

[1] Man pages at the case directory in flat text files:
    materials/*.3c
[2] The Unicode standard:
    http://www.unicode.org/standard/standard.html
[3] Unicode Standard Annex #15: UNICODE NORMALIZATION FORMS
    http://www.unicode.org/reports/tr15/