Print this page
Garrett's man page edits.
@@ -9,76 +9,67 @@
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright (c) 2014 Joyent, Inc. All rights reserved.
+.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
.\"
-.TH TOWUPPER 3C "Jun 11, 2014"
-
+.TH TOWUPPER 3C "Jun 21, 2014"
.SH NAME
-
towupper, towupper_l \- transliterate lower-case wide characters to upper-case
-
.SH SYNOPSIS
-
.LP
.nf
#include <wctype.h>
-.BI "wint_t towupper(wint_t" wc );
-.BI "wint_t towupper_l(wint_t" wc, " locale_t " loc );
-
+\fBwint_t\fR \fBtowupper\fR(\fBwint_t\fR \fIwc\fR);
+.fi
+.LP
+.nf
+\fBwint_t\fR \fBtowupper_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
+.fi
.SH DESCRIPTION
-
The function
-.BR towupper
+.BR towupper()
is the wide character equivalent of the function
-.BR toupper .
+.BR toupper (3C).
It converts the lower-case wide character
-.I loc
+.I wc
to the equivalent upper-case
wide character, if one exists. If one does not exist, it returns
-.I loc
+.I wc
unchanged.
-
.LP
The function
-.B towupper_l
+.B towupper_l()
is equivalent to the function
-.BR towupper ,
-but instead of operating in the current environemnt, operates on the
-environment specified by
+.BR towupper() ,
+but instead of operating in the current locale, operates in the
+locale specified by
.IR loc .
-
.SH RETURN VALUES
-
On successful completion,
.B towupper()
and
.B towupper_l()
return the upper-case character that corresponds to the argument passed.
Otherwise, they return the argument unchanged.
-
.SH ERRORS
-
No errors are defined.
-
.SH ATTRIBUTES
-.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Interface Stability Standard
_
-MT-Level Safe
+MT-Level MT-Safe
.TE
.SH SEE ALSO
-.BR duplocale (3C),
.BR newlocale (3C),
.BR setlocale (3C),
-.BR tolower(3C),
-.BR environ (5),
+.BR toupper(3C),
+.BR uselocale (3C),
.BR locale (5)