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