ctype(3): Fix versions and clarify what LIBC_ALLOWCTYPEABUSE does.

Both the extra diagnostics _and_ LIBC_ALLOWCTYPEABUSE are new in 11.
The extra diagnostics were not added in 10 (unless someone went ahead
and pulled them up while I wasn't looking!).

LIBC_ALLOWCTYPEABUSE doesn't guarantee that the program won't crash;
it just makes that depend on factors such as address space layout
randomization -- where the ctype tables appear in memory relative to
non-readable pages.

PR lib/58208: ctype(3) provides poor runtime feedback of abuse

ctype(3): Clarify test program output. Update compiler warning.

Should be a little easier to read. The fact that isprint returns
_any_ nonzero value, not necessarily 1, isn't germane to the point
here, so showing it return 5 or 2 doesn't really help to illustrate
anything.

Tweak version numbers, the LIBC_ALLOWCTYPEABUSE env support
has been pulled up.

ctype(3): Document LIBC_ALLOWCTYPEABUSE.

If this is pulled up to netbsd-11, we should tweak the text to make
it apply to 11 too.

PR lib/58208: ctype(3) provides poor runtime feedback of abuse

branches: 1.31.14;
Use \- for minus.

Fly, nasal demons, fly away...

Use the same variable for the locale example.

Don't talk about "the first argument" when there's only one.

Fix markup pasto.

Remove the extra cast to int in the CAVEATS example.
We removed it from EXAMPLES a few releases ago.

Fix typo in macro flag.

Expand on correct and incorrect usage, and on compiler warnings.

Give an example program with the warning, and some example nonsense
outputs. Also note why glibc's approach doesn't solve the problem.

branches: 1.23.2; 1.23.4;
Add ctype to the NAME section (as this is a man page for ctype)
Remove rest of the names from the NAME section
(These names have their own individual man pages, as such it doesn't make sense
to have their names in the NAME section in this man page as well. Moreover,
we have been trying to fix such man pages so that apropos(1)/whatis(1) are
able to search these man pages. Other examples of such fixed man pages include
memory(3), string(3) etc.)

ok wiz@

Remove sentence about casting to int (also from example).
Bump date.

ok joerg@

Note POSIX compliance. Reword a little around the example.

\\ -> \e

Give the full prototype for all ctype functions/macros.
Remove redundant .br.

branches: 1.18.10; 1.18.12;
* Expand the CAVEATS section with a lot more detail on how to safely
use the ctype functions.
* Use toupper((int)(unsigned char)*s)) instead of just
toupper((unsigned char)*s) in an example.

Sort sections.

isascii() and toascii() are defined for all integers unlike the other
functions. Explicitely mention "undefined behavior".

Added a warning about a wrong usage, which is nevertheless often found
in real code, and an example code that does it correctly.

Serial comma; bump date for previous.

.St -ansiC doesn't know about isascii().

s/macro/function/g

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Generate <>& symbolically.

Standardize section headers, sort sections, sort SEE ALSO, punctuation
and misc. fixes.

branches: 1.7.12;
add LIBRARY section to man page

merge with Lite, keep local changes. clean up id usage

Manpage formatting tweaks.

Misc manpage fixes.

Document isblank().

Add RCS identifiers.

branches: 1.1.1;
Initial revision