locale.5: Document LC_TELEPHONE

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

man5/locale.5

@@ -56,8 +56,8 @@ 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_ADDRESS, LC_IDENTIFICATION.
-.\" LC_TELEPHONE.  These need to be documented.
+.\" These need to be documented.
 .SS Locale category sections
 The following category sections are defined by POSIX:
 .IP * 3
@@ -661,6 +661,59 @@ The
 .B LC_PAPER
 definition ends with the string
 .IR "END LC_PAPER" .
+.SS LC_TELEPHONE
+The definition starts with the string
+.B LC_TELEPHONE
+in the first column.
+
+The following keywords are allowed:
+.TP
+.I tel_int_fmt
+followed by a string that contains field descriptors that identify
+the format used to dial international numbers.
+The following field descriptors are recognized:
+.\" From localedata/locales/uk_UA
+.RS
+.TP
+%a
+Area code without nationwide prefix (the prefix is often "0").
+.TP
+%A
+Area code including nationwide prefix.
+.TP
+%l
+Local number (within area code).
+.TP
+%e
+Extension (to local number).
+.TP
+%c
+Country code.
+.TP
+%C
+Alternate carrier service code used for dialling abroad.
+.TP
+%t
+If the preceding field descriptor resulted in an empty string,
+then the empty string, otherwise a space character.
+.RE
+.TP
+.I tel_dom_fmt
+followed by a string that contains field descriptors that identify
+the format used to dial domestic numbers.
+The recognized field descriptrs are the same as for
+.IR tel_int_fmt .
+.TP
+.I int_select
+followed by the prefix used to call international phone numbers.
+.TP
+.I int_prefix
+followed by the prefix used from other countries to dial this country.
+.PP
+The
+.B LC_TELEPHONE
+definition ends with the string
+.IR "END LC_TELEPHONE" .
 .SS LC_TIME
 The definition starts with the string
 .B LC_TIME