Re: [PATCH 2/2] man.7, uri.7: Use "www.kernel.org" in example URLs

[walter harms <wharms-fPG8STNUNVg@public.gmane.org>]

Am 06.02.2017 08:08, schrieb Michael Kerrisk (man-pages):
> Hi Walter,
> 
> On 4 February 2017 at 13:46, walter harms <wharms-fPG8STNUNVg@public.gmane.org> wrote:
>>
>>
>> Am 04.02.2017 12:11, schrieb Michael Kerrisk (man-pages):
>>> On 02/04/2017 11:49 PM, Jakub Wilk wrote:
>>>> Apparently www.kernelnotes.org is now a spam site.
>>>
>>> Charming!
>>>
>>> Thanks for the patch, Jakub. Applied.
>>>
>>> Cheers,
>>>
>>> Michael
>>>
>>>
>>>> Signed-off-by: Jakub Wilk <jwilk-tXgOlIzOKNReoWH0uzbU5w@public.gmane.org>
>>>> ---
>>>>  man7/man.7 | 2 +-
>>>>  man7/uri.7 | 4 ++--
>>>>  2 files changed, 3 insertions(+), 3 deletions(-)
>>>>
>>>> diff --git a/man7/man.7 b/man7/man.7
>>>> index ca063c3fd..aae04bfe8 100644
>>>> --- a/man7/man.7
>>>> +++ b/man7/man.7
>>>> @@ -487,7 +487,7 @@ You can also use the new
>>>>  macro to identify links to related information.
>>>>  If you include URLs, use the full URL
>>>>  (e.g.,
>>>> -.UR http://www.kernelnotes.org
>>>> +.UR http://www.kernel.org
>>>>  .UE )
>>>>  to ensure that tools can automatically find the URLs.
>>>>  .PP
>>>> diff --git a/man7/uri.7 b/man7/uri.7
>>>> index 427f8ff83..39d876055 100644
>>>> --- a/man7/uri.7
>>>> +++ b/man7/uri.7
>>>> @@ -82,7 +82,7 @@ the resource ceases to exist or becomes unavailable.
>>>>  .PP
>>>>  URIs are the standard way to name hypertext link destinations
>>>>  for tools such as web browsers.
>>>> -The string "http://www.kernelnotes.org" is a URL (and thus it
>>>> +The string "http://www.kernel.org" is a URL (and thus it
>>>>  is also a URI).
>>>>  Many people use the term URL loosely as a synonym for URI
>>>>  (though technically URLs are a subset of URIs).
>>>> @@ -538,7 +538,7 @@ use the URI escaping mechanism, that is,
>>>>  use the %HH encoding for unsafe octets.
>>>>  .SS Writing a URI
>>>>  When written, URIs should be placed inside double quotes
>>>> -(e.g., "http://www.kernelnotes.org"),
>>>> +(e.g., "http://www.kernel.org"),
>>>>  enclosed in angle brackets (e.g., <http://lwn.net>),
>>>>  or placed on a line by themselves.
>>>>  A warning for those who use double-quotes:
>>>>
>>>
>>
>>
>> I am not sure that is it a good idea to use real domain names here.
> 
> I think it's okay, in this case. Presumably, www.kernel.org will be
> with us at least as long as the man pages, and I do not mind that a
> man page gives a nod to lwn.net.
> 
I think it gives a bad example and it is not needed. Given  www.kernel.org
will be very stable but since the man page is about URI we could use any.

just my 2 cents, do as you like ...

re,
 wh

> Cheers,
> 
> Michael
> 
> 
--
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