locale.5: drop tel/fax description

locale.5: drop tel/fax description

[Marko Myllynen]

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(-)

diff --git a/man5/locale.5 b/man5/locale.5
index 0a26f91..cc6edf2 100644
--- a/man5/locale.5
+++ b/man5/locale.5
@@ -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,

-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: locale.5: drop tel/fax description

[walter harms]

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:
> 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(-)
> 
> diff --git a/man5/locale.5 b/man5/locale.5
> index 0a26f91..cc6edf2 100644
> --- a/man5/locale.5
> +++ b/man5/locale.5
> @@ -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,
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: locale.5: drop tel/fax description

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 438 bytes --]

On 07 Mar 2016 13:52, Marko Myllynen wrote:
> 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

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]

Re: locale.5: drop tel/fax description

[Marko Myllynen]

On 2016-03-07 19:48, Mike Frysinger wrote:
> On 07 Mar 2016 13:52, Marko Myllynen wrote:
>> 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(+)

diff --git a/man5/locale.5 b/man5/locale.5
index 0a26f91..ef97f00 100644
--- a/man5/locale.5
+++ b/man5/locale.5
@@ -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,

-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: locale.5: drop tel/fax description

[walter harms]

Am 08.03.2016 10:59, schrieb Marko Myllynen:
> On 2016-03-07 19:48, Mike Frysinger wrote:
>> On 07 Mar 2016 13:52, Marko Myllynen wrote:
>>> 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(+)
> 
> diff --git a/man5/locale.5 b/man5/locale.5
> index 0a26f91..ef97f00 100644
> --- a/man5/locale.5
> +++ b/man5/locale.5
> @@ -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,
> 

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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: locale.5: drop tel/fax description

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 611 bytes --]

On 08 Mar 2016 11:59, Marko Myllynen wrote:
> On 2016-03-07 19:48, Mike Frysinger wrote:
> > On 07 Mar 2016 13:52, Marko Myllynen wrote:
> >> 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

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]

Re: locale.5: drop tel/fax description

[Michael Kerrisk (man-pages)]

On 03/08/2016 10:59 AM, Marko Myllynen wrote:
> On 2016-03-07 19:48, Mike Frysinger wrote:
>> On 07 Mar 2016 13:52, Marko Myllynen wrote:
>>> 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
 
> ---
>  man5/locale.5 | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/man5/locale.5 b/man5/locale.5
> index 0a26f91..ef97f00 100644
> --- a/man5/locale.5
> +++ b/man5/locale.5
> @@ -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,
> 


-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html