.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
-.\"
+.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
-.\"
+.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.BI "char *setlocale(int " category ", const char *" locale );
.fi
.SH DESCRIPTION
-The
+The
.BR setlocale ()
function is used to set or query the program's current locale.
.PP
is
.BR """""" ,
each part of the locale that should be modified is set according to the
-environment variables. The details are implementation dependent.
+environment variables.
+The details are implementation dependent.
For glibc, first
.\" [This is false on my system - must check which library versions do this]
.\" if
and by using
.BR strcoll () ,
.BR wcscoll ()
-or
-.BR strxfrm (),
+or
+.BR strxfrm (),
.BR wcsxfrm ()
to compare strings.
.SH "RETURN VALUE"
This string may be allocated in static storage.
The string returned is such that a subsequent call with that string
and its associated category will restore that part of the process's
-locale.
+locale.
The return value is NULL if the request cannot be honored.
.SH "CONFORMING TO"
C89, C99, POSIX.1-2001.
Linux (that is, GNU libc) supports the portable locales
.BR """C""" " and " """POSIX""" .
In the good old days there used to be support for
-the European Latin-1
+the European Latin-1
.B """ISO-8859-1"""
locale (e.g. in libc-4.5.21 and libc-4.6.27), and the Russian
.B """KOI-8"""
(more precisely, "koi-8r") locale (e.g. in libc-4.6.27),
so that having an environment variable LC_CTYPE=ISO-8859-1
-sufficed to make
-.BR isprint ()
+sufficed to make
+.BR isprint ()
return the right answer.
These days non-English speaking Europeans have to work a bit harder,
and must install actual locale files.