pg.ddx.io  pgsql-bugs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: Michael Paquier <michael@paquier.xyz>
To: Jobin Augustine <jobinau@gmail.com>
Cc: Heikki Linnakangas <hlinnaka@iki.fi>
Cc: Oleksandr Shulgin <oleksandr.shulgin@zalando.de>
Cc: pgsql-bugs@lists.postgresql.org
Subject: Re: libpq parameter parsing problem
Date: Wed, 15 Jan 2020 16:42:28 +0100
Message-ID: <fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com> (raw)
In-Reply-To: <20200114060317.GF1515@paquier.xyz>
References: <CANaTPsrYgSgE2fuj3=4x=Jmx1c+NgkEDzftNknZbrMuqL+aBhQ@mail.gmail.com>
	<CACACo5Qf4xBbs=8s4sYxZiQEYzfKM3JY3uCDrtZYu3CpOcP5xA@mail.gmail.com>
	<CANaTPsrgsrVK2nb6bPym-fZcQvL7aJErMCXek7LBp-QFDQt-RQ@mail.gmail.com>
	<22b4a79a-5d60-cec0-474e-4a68c8be2b7a@iki.fi>
	<20200109043809.GK2251@paquier.xyz>
	<CANaTPsqq17XvXDsrm4J6GXZqnNw=0=Y+txMRyBBTJn4sGJw9ig@mail.gmail.com>
	<20200114060317.GF1515@paquier.xyz>

On 2020-01-14 07:03, Michael Paquier wrote:
>>      <para>
>> -    Percent-encoding may be used to include symbols with special meaning in any
>> -    of the <acronym>URI</acronym> parts, e.g. replace <literal>=</literal> with
>> -    <literal>%3D</literal>.
>> -
>> +    Connection <acronym>URI</acronym> need to be encoded with
>> +    <ulink url="https://en.wikipedia.org/wiki/Percent-encoding">Percent-encoding</ulink;
>> +    if it includes symbols with special meaning in any of its parts.
>> +    For example:
>> +<programlisting>
>> +postgresql://postgres@localhost:5432/postgres?options=-c%20synchronous_commit%3Doff%20-c%20geqo%3Doff
>> +</programlisting>
>> +    where all <literal>=</literal> are replaced with <literal>%3D</literal> and
>> +    space character with <literal>%20</literal>
>>      </para>
> 
> The reference to wikipedia is nice to have.

Let's please not put links to Wikipedia into the main body of the 
documentation.  If people want to look up something, they know where to 
find it.

Links to authoritative sources (perhaps an RFC in this case) would be 
better.

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





view thread (22+ messages)  latest in thread

Message-ID: <fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com>
Permalink:  ../fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com/
Also on:    postgresql.org/message-id/fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-bugs@postgresql.org
  Cc: peter.eisentraut@2ndquadrant.com, michael@paquier.xyz, jobinau@gmail.com, hlinnaka@iki.fi, oleksandr.shulgin@zalando.de
  Subject: Re: libpq parameter parsing problem
  In-Reply-To: <fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com>
  References: <CANaTPsrYgSgE2fuj3=4x=Jmx1c+NgkEDzftNknZbrMuqL+aBhQ@mail.gmail.com> <CACACo5Qf4xBbs=8s4sYxZiQEYzfKM3JY3uCDrtZYu3CpOcP5xA@mail.gmail.com> <CANaTPsrgsrVK2nb6bPym-fZcQvL7aJErMCXek7LBp-QFDQt-RQ@mail.gmail.com> <22b4a79a-5d60-cec0-474e-4a68c8be2b7a@iki.fi> <20200109043809.GK2251@paquier.xyz> <CANaTPsqq17XvXDsrm4J6GXZqnNw=0=Y+txMRyBBTJn4sGJw9ig@mail.gmail.com> <20200114060317.GF1515@paquier.xyz> <fe1a7b9f-5630-00dd-3780-1b150a583fdf@2ndquadrant.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox