locale.5: Document LC_NAME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-03 15:07:31 +01:00
parent d8672381b3
commit 929e0bf78c
1 changed files with 84 additions and 1 deletions

View File

@ -56,7 +56,7 @@ the only valid keyword in the definition is
.B copy
followed by the name of the locale which should be copied.
.\" FIXME glibc 2.2.2 added new nonstandard locale categories:
.\" LC_ADDRESS, LC_IDENTIFICATION, LC_NAME,
.\" LC_ADDRESS, LC_IDENTIFICATION,
.\" LC_TELEPHONE. These need to be documented.
.SS Locale category sections
The following category sections are defined by POSIX:
@ -538,6 +538,89 @@ The
.B LC_MONETARY
definition ends with the string
.IR "END LC_MONETARY" .
.SS LC_NAME
The definition starts with the string
.B LC_NAME
in the first column.
The following keywords are allowed:
.TP
.I name_fmt
followed by a string containing field descriptors that define
the format used for names in the locale.
The following field descriptors are recognized:
.\" From localedata/locales/uk_UA:
.RS
.TP
%f
Family name(s).
.TP
%F
Family names in uppercase.
.TP
%g
First given name.
.TP
%G
First given initial.
.TP
%l
First given name with Latin letters.
.TP
%o
Other shorter name.
.TP
%m
Additional given name(s).
.TP
%M
Initials for additional given name(s).
.TP
%p
Profession.
.TP
%s
Salutation, such as "Doctor".
.TP
%S
Abbreviated salutation, such as "Mr." or "Dr.".
.TP
%d
Salutation, using the FDCC-sets conventions.
.\" 1 for the name_gen
.\" In glibc 2.19, %d1 is used in only:
.\" /home/mtk/ARCHIVE/GLIBC/glibc-2.19/localedata/locales/bem_ZM
.\" /home/mtk/ARCHIVE/GLIBC/glibc-2.19/localedata/locales/zh_HK
.\" In glibc 2.19, %d[2-5] appear to be not used at all
.\" 2 for name_mr
.\" 3 for name_mrs
.\" 4 for name_miss
.\" 5 for name_ms
.TP
%t
If the preceding field descriptor resulted in an empty string,
then the empty string, otherwise a space character.
.RE
.TP
.I name_gen
followed by the general salutation for any gender.
.TP
.I name_mr
followed by the salutation for men.
.TP
.I name_mrs
followed by the salutation for married women.
.TP
.I name_miss
followed by the salutation for unmarried women.
.TP
.I name_ms
followed by the salutation valid for all women.
.PP
The
.B LC_NAME
definition ends with the string
.IR "END LC_NAME" .
.SS LC_NUMERIC
The definition starts with the string
.B LC_NUMERIC