Skip to contentSkip to conversation

locale.5: drop tel/fax description

PATCH Applied Marko Myllynen 4 participants 7 messages Mar 7, 2016 – Mar 8, 2016 3 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

Hi Michael,

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

https://sourceware.org/git/?p=glibc.git;a=commit;h=5453f739e5fae1f9235c3207a8604f164dc9e484

---
 man5/locale.5 | 8 --------
 1 file changed, 8 deletions(-)
man5/locale.5 +0 -8
index 0a26f91..cc6edf2 100644
@@ -569,14 +569,6 @@ the organization that maintains this document.
 followed by the email address of the person or
 organization that maintains this document.
 .TP
-.I tel
-followed by the telephone number (in international format)
-of the organization that maintains this document.
-.TP
-.I fax
-followed by the fax number (in international format)
-of the organization that maintains this document.
-.TP
 .I language
 followed by the name of the language to which this document applies.
 .TP

Thanks,

Signature · 5 lines
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw

It should simply be noted that these fields are droped since glibc xyz

Others may support them and it is stil valid for older version.

re,
wh

Am 07.03.2016 12:52, schrieb Marko Myllynen:

Quoted 32 lines

Hi Michael,

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

https://sourceware.org/git/?p=glibc.git;a=commit;h=5453f739e5fae1f9235c3207a8604f164dc9e484

---
 man5/locale.5 | 8 --------
 1 file changed, 8 deletions(-)
man5/locale.5 +0 -8
index 0a26f91..cc6edf2 100644
@@ -569,14 +569,6 @@ the organization that maintains this document.
 followed by the email address of the person or
 organization that maintains this document.
 .TP
-.I tel
-followed by the telephone number (in international format)
-of the organization that maintains this document.
-.TP
-.I fax
-followed by the fax number (in international format)
-of the organization that maintains this document.
-.TP
 .I language
 followed by the name of the language to which this document applies.
 .TP
Quoted 2 lines

Thanks,

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

#3 lore raw
In reply to a message not in the archive
Quoted 3 lines · Marko Myllynen

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

the fields are technically still supported, we've just emptied them out. i would add a note saying that their use is discouraged in favor of the other fields like e-mail.
-mike

A message that is not in the archive (sent off-list or not yet received): [email protected]

#5 lore raw
Quoted 8 lines · Mike Frysinger
Quoted 3 lines · Marko Myllynen

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

the fields are technically still supported, we've just emptied them out. i would add a note saying that their use is discouraged in favor of the other fields like e-mail.

Fair enough, how about this?

---
 man5/locale.5 | 4 ++++
 1 file changed, 4 insertions(+)
man5/locale.5 +4 -0
index 0a26f91..ef97f00 100644
@@ -572,10 +572,14 @@ organization that maintains this document.
 .I tel
 followed by the telephone number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I fax
 followed by the fax number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I language
 followed by the name of the language to which this document applies.

Thanks,

Signature · 5 lines
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#7 lore raw

Am 08.03.2016 10:59, schrieb Marko Myllynen:

Quoted 36 lines · Mike Frysinger
Quoted 8 lines · Marko Myllynen
Quoted 3 lines

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

the fields are technically still supported, we've just emptied them out. i would add a note saying that their use is discouraged in favor of the other fields like e-mail.

Fair enough, how about this?

---
 man5/locale.5 | 4 ++++
 1 file changed, 4 insertions(+)
man5/locale.5 +4 -0
index 0a26f91..ef97f00 100644
@@ -572,10 +572,14 @@ organization that maintains this document.
 .I tel
 followed by the telephone number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I fax
 followed by the fax number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I language
 followed by the name of the language to which this document applies.
Quoted 2 lines

Thanks,

I think "As of glibc 2.24, this keyword is deprecated" is enought. Otherwise it may spark discussions.

re,
wh
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

#8 lore raw
In reply to a message not in the archive
Quoted 11 lines · Marko Myllynen
Quoted 8 lines · Mike Frysinger
Quoted 3 lines · Marko Myllynen

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

the fields are technically still supported, we've just emptied them out. i would add a note saying that their use is discouraged in favor of the other fields like e-mail.

Fair enough, how about this?

lgtm
-mike

#9 lore raw
In reply to a message not in the archive
Quoted 11 lines · Marko Myllynen
Quoted 8 lines · Mike Frysinger
Quoted 3 lines · Marko Myllynen

glibc upstream recently deemed that the tel/fax fields are not useful and dropped them from the few locales which had them defined. Do you think we could/should drop the descriptions from the man page as well?

the fields are technically still supported, we've just emptied them out. i would add a note saying that their use is discouraged in favor of the other fields like e-mail.

Fair enough, how about this?

Applied, thanks.

Michael

Quoted 26 lines
---
 man5/locale.5 | 4 ++++
 1 file changed, 4 insertions(+)
man5/locale.5 +4 -0
index 0a26f91..ef97f00 100644
@@ -572,10 +572,14 @@ organization that maintains this document.
 .I tel
 followed by the telephone number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I fax
 followed by the fax number (in international format)
 of the organization that maintains this document.
+As of glibc 2.24, this keyword is deprecated in favor of
+other contact methods.
 .TP
 .I language
 followed by the name of the language to which this document applies.

Thanks,

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html