locale.5: Document LC_NAME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man5/locale.5 b/man5/locale.5
index 83c4a314b825051aea86c2c7eff87d9bab905e48..323f26368c268abe014e9a9bf151a6b56a3462a9 100644 (file)
--- a/man5/locale.5
+++ b/man5/locale.5
@@ -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