Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Per Regents of the University of Calfornia letter, remove advertising
clause.

# If I've done so improperly on a file, please let me know.

Remove support for the obsolete UTF2 encoding.

Markup, grammar, and spelling fixes.

Update manual pages for change to C99 mbrtowc() semantics.

Split multibyte(3) into separate manual pages for each function.
Instead of just deleting it, turn the original page into a general
overview of the multibyte character conversion functions, somewhat
similar to stdio(3).

Update cross references after utf2/euc move.

Add one more cross-reference to gb2312(5).

Cross-reference gbk(5).

Add cross references to the new character encoding manual pages,
and to mbsinit(3) while I'm at it.

The .Fn function

Add a UTF-8 encoding method, which will eventually replace the antique
"UTF2" method. Although UTF-8 and the old UTF2 encoding are compatible
for 16-bit characters, the new UTF-8 implementation is much more strict
about rejecting malformed input and also handles the full 31 bit range
of characters.

Remove a completely incorrect statement from the Return Values section.
Add cross-references to the restartable mulitybte functions (mbrlen(3) etc.)

Style: One space between "restrict" qualifier and "*".

Typo: refer to MB_LEN_MAX instead of MB_CHAR_MAX (which does not exist).

Add restrict qualifiers to the arguments of mbstowcs, mbtowc() and
wcstombs().

Add btowc(3) to SEE ALSO section.

mdoc(7) police: Use the new .In macro for #include statements.

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Remove whitespace at EOL.

.St -ansiC -> .St -isoC

mdoc(7) police: split punctuation characters + misc fixes.

Introduce ".Lb" macro to libc manpages.

More libraries manpages updates following.

$Id$ -> $FreeBSD$

Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde

Show the real revision date and not the date that this
manpage is being viewed.

FIxed arg types (mostly missing consts) in synopsis.

Sort cross references.

This commit was generated by cvs2svn to compensate for changes in r1573,
which included commits to RCS files with non-trunk default branches.

BSD 4.4 Lite Lib Sources