Re: Add PostgreSQL home page to --help output

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: Greg Stark <stark(at)mit(dot)edu>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Add PostgreSQL home page to --help output
Date: 2020-02-28 13:02:17
Message-ID: f68f2a93-c98a-4a7e-818b-39cf77e7d4da@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 2020-02-20 12:09, Daniel Gustafsson wrote:
>> On 20 Feb 2020, at 10:53, Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
>>
>>> On 20 Feb 2020, at 10:15, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> wrote:
>>>
>>> On 2020-02-13 14:24, Greg Stark wrote:
>>>> Sounds like a fine idea. But personally I would prefer it without the <> around the it, just a url on a line by itself. I think it would be clearer, look cleaner, and be easier to select to copy/paste elsewhere.
>>>
>>> I'm on the fence about this one, but I like the delimiters because it would also work consistently if we put a URL into running text where it might be immediately adjacent to other characters. So I was actually going for easier to copy/paste here, but perhaps in other environments it's not easier?
>>
>> For URLs completely on their own, not using <> makes sense. Copy pasting <url>
>> into the location bar of Safari makes it load the url, but Firefox and Chrome
>> turn it into a search engine query (no idea about Windows browsers).
>>
>> For URLs in running text it's not uncommon to have <> around the URL for the
>> very reason you mention. Looking at --help and manpages from random open
>> source tools there seems to be roughly a 50/50 split on using <> or not.
>
> RFC3986 discuss this in <https://tools.ietf.org/html/rfc3986#appendix-C>, with
> the content mostly carried over from RFC2396 appendix E.

I think we weren't going to get any more insights here, so I have
committed it as is.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2020-02-28 13:14:51 HAVE_WORKING_LINK still needed?
Previous Message Alexey Kondratov 2020-02-28 12:37:47 Re: [Patch] pg_rewind: options to use restore_command from recovery.conf or command line