.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
-.TH LOCALE 1 2016-03-15 "Linux" "Linux User Manual"
+.TH LOCALE 1 2019-03-06 "Linux" "Linux User Manual"
.SH NAME
locale \- get locale-specific information
.SH SYNOPSIS
.nf
.BR locale " [\fIoption\fP]"
-.BR locale " [\fIoption\fP] \-a"
-.BR locale " [\fIoption\fP] \-m"
+.BR locale " [\fIoption\fP] " \-a
+.BR locale " [\fIoption\fP] " \-m
.BR locale " [\fIoption\fP] \fIname\fP..."
.fi
.SH DESCRIPTION
.B locale
command displays information about the current locale, or all locales,
on standard output.
-
+.PP
When invoked without arguments,
.B locale
displays the current locale settings for each locale category (see
.BR locale (7)).
Values for variables set in the environment are printed without double
quotes, implied values are printed with double quotes.
-
+.PP
If either the
.B \-a
or the
or
.IR decimal_point )
or locale categories (for example,
-.BR LC_CTYPE
+.B LC_CTYPE
or
.BR LC_TIME ).
For each argument, the following is displayed:
For a category name argument,
write the name of the locale category
on a separate line preceding the list of keyword values for that category.
-
+.IP
For a keyword name argument,
write the name of the locale category for this keyword
on a separate line preceding the keyword value.
-
+.IP
This option improves readability when multiple name arguments are specified.
It can be combined with the
.B \-k
For each keyword whose value is being displayed,
include also the name of that keyword,
so that the output has the format:
-
+.IP
\fIkeyword\fP="\fIvalue\fP"
.PP
The
.BR \-? ", " \-\-help
Display a summary of command-line options and arguments and exit.
.TP
-.BR \-\-usage
+.B \-\-usage
Display a short usage message and exit.
.TP
.BR \-V ", " \-\-version
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008.
.SH EXAMPLE
-.nf
+.EX
$ \fBlocale\fP
LANG=en_US.UTF\-8
LC_CTYPE="en_US.UTF\-8"
int_select="11"
int_prefix="1"
telephone\-codeset="UTF\-8"
-.fi
-
+.EE
+.PP
The following example compiles a custom locale from the
.I ./wrk
directory with the
.B LANG
in the shell profile file so that the custom locale will be used in the
subsequent user sessions:
-
-.nf
+.PP
+.EX
$ \fBmkdir -p $HOME/.locale\fP
$ \fBI18NPATH=./wrk/ localedef -f UTF-8 -i fi_SE $HOME/.locale/fi_SE.UTF-8\fP
$ \fBLOCPATH=$HOME/.locale LC_ALL=fi_SE.UTF-8 date\fP
-$ \fBecho "export LOCPATH=\\$HOME/.locale" >> $HOME/.bashrc\fP
+$ \fBecho "export LOCPATH=\e$HOME/.locale" >> $HOME/.bashrc\fP
$ \fBecho "export LANG=fi_SE.UTF-8" >> $HOME/.bashrc\fP
-.fi
+.EE
.SH SEE ALSO
.BR localedef (1),
.BR charmap (5),