.\" $OpenBSD: locale.1,v 1.4 2014/03/24 07:29:22 jmc Exp $
.\"
.\" Copyright 2013 Stefan Sperling <stsp@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: March 24 2014 $
.Dt LOCALE 1
.Os
.Sh NAME
.Nm locale
.Nd get locale-specific information
.Sh SYNOPSIS
.Nm locale
.Op Fl a | Fl m
.Sh DESCRIPTION
If
.Nm
is invoked without any arguments, the current locale configuration is shown.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a
Display a list of supported locales.
.It Fl m
Display a list of supported character sets.
.El
.Sh ENVIRONMENT
The locale configuration consists of the following environment variables:
.Pp
.Bl -tag -width LC_MONETARYXXX -compact
.It Dv LC_ALL
Overrides all other LC_* variables below.
.It Dv LC_COLLATE
Locale for string collation routines.
.It Dv LC_CTYPE
Locale for character set.
.It Dv LC_MONETARY
Locale for formatting monetary values.
.It Dv LC_NUMERIC
Locale for formatting numbers.
.It Dv LC_TIME
Locale for formatting dates and times.
.It Dv LANG
Fallback if any of the above is unset.
.El
.Sh EXIT STATUS
.Ex -std locale
.Sh SEE ALSO
.Xr setlocale 3
.Sh STANDARDS
The
.Nm
utility implements a subset of the
.St -p1003.1-2008
specification.
.Sh HISTORY
The
.Nm
utility was first standardized in the
.St -xpg4 .
.Pp
It was rewritten from scratch for
.Ox 5.4
during the 2013 Toronto hackathon.
.Sh AUTHORS
.An -nosplit
.An Stefan Sperling Aq Mt stsp@openbsd.org
with contributions from
.An Philip Guenther Aq Mt guenther@openbsd.org
and
.An Jeremie Courreges-Anglas Aq Mt jca@openbsd.org .
.Sh BUGS
The list of supported locales is perpetually incomplete.