diff --git a/man5/locale.5 b/man5/locale.5 index 83c4a314b..323f26368 100644 --- 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