towlower.3: Largely rewrite description of towlower() to be simpler and clearer

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-09 15:32:38 +01:00
parent 15f0518679
commit 04b5684a63
1 changed files with 21 additions and 18 deletions

View File

@ -1,4 +1,5 @@
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\" and Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
@ -30,26 +31,28 @@ function is the wide-character equivalent of the
function.
If
.I wc
is a wide character, it is converted to
lowercase.
Characters which do not have case are returned unchanged.
If
.IR wc
is
.BR WEOF ,
.B WEOF
is returned.
.SH RETURN VALUE
The
.BR towlower ()
function returns the lowercase equivalent of
.IR wc ,
or
.BR WEOF
if
is an uppercase wide character,
and there exists a lowercase equivalent in the current locale,
it returns the lowercase equivalent of
.IR wc .
In all other cases,
.I wc
is
is returned unchanged.
The argument
.I wc
must be representable as a
.IR wchar_t
and be a valid character in the locale or the value
.BR WEOF .
.SH RETURN VALUE
If
.I wc
was convertible to lowercase,
.BR towlower ()
returns its lowercase equivalent;
otherwise it returns
.IR wc .
.SH ATTRIBUTES
.SS Multithreading (see pthreads(7))
The