Annotation of src/usr.bin/locale/locale.1, Revision 1.5
1.5 ! zhuk 1: .\" $OpenBSD: locale.1,v 1.4 2014/03/24 07:29:22 jmc Exp $
1.1 stsp 2: .\"
3: .\" Copyright 2013 Stefan Sperling <stsp@openbsd.org>
4: .\"
5: .\" Permission to use, copy, modify, and distribute this software for any
6: .\" purpose with or without fee is hereby granted, provided that the above
7: .\" copyright notice and this permission notice appear in all copies.
8: .\"
9: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: .\"
1.5 ! zhuk 17: .Dd $Mdocdate: March 24 2014 $
1.1 stsp 18: .Dt LOCALE 1
19: .Os
20: .Sh NAME
21: .Nm locale
22: .Nd get locale-specific information
23: .Sh SYNOPSIS
24: .Nm locale
25: .Op Fl a | Fl m
26: .Sh DESCRIPTION
27: If
28: .Nm
29: is invoked without any arguments, the current locale configuration is shown.
30: .Pp
31: The options are as follows:
32: .Bl -tag -width Ds
33: .It Fl a
34: Display a list of supported locales.
35: .It Fl m
36: Display a list of supported character sets.
37: .El
38: .Sh ENVIRONMENT
39: The locale configuration consists of the following environment variables:
1.2 jmc 40: .Pp
41: .Bl -tag -width LC_MONETARYXXX -compact
1.1 stsp 42: .It Dv LC_ALL
43: Overrides all other LC_* variables below.
44: .It Dv LC_COLLATE
45: Locale for string collation routines.
46: .It Dv LC_CTYPE
47: Locale for character set.
1.5 ! zhuk 48: .It Dv LC_MESSAGES
! 49: Locale for message strings.
1.1 stsp 50: .It Dv LC_MONETARY
51: Locale for formatting monetary values.
52: .It Dv LC_NUMERIC
53: Locale for formatting numbers.
54: .It Dv LC_TIME
55: Locale for formatting dates and times.
56: .It Dv LANG
57: Fallback if any of the above is unset.
58: .El
1.4 jmc 59: .Sh EXIT STATUS
60: .Ex -std locale
1.1 stsp 61: .Sh SEE ALSO
62: .Xr setlocale 3
63: .Sh STANDARDS
64: The
65: .Nm
1.4 jmc 66: utility implements a subset of the
67: .St -p1003.1-2008
68: specification.
1.3 schwarze 69: .Sh HISTORY
70: The
71: .Nm
72: utility was first standardized in the
73: .St -xpg4 .
74: .Pp
75: It was rewritten from scratch for
76: .Ox 5.4
77: during the 2013 Toronto hackathon.
78: .Sh AUTHORS
1.4 jmc 79: .An -nosplit
1.3 schwarze 80: .An Stefan Sperling Aq Mt stsp@openbsd.org
81: with contributions from
82: .An Philip Guenther Aq Mt guenther@openbsd.org
83: and
84: .An Jeremie Courreges-Anglas Aq Mt jca@openbsd.org .
1.1 stsp 85: .Sh BUGS
86: The list of supported locales is perpetually incomplete.