Commite0ed681

committed

Doc: Improve description of connection strings with Percent-encoding

Clarify the description related to the use of characters which can beencoded, and add an example.Author: Jobin AugustineReviewed-by: Peter Eisentraut, Alvaro Herrera, Heikki Linnakangas,Michael Paquier, Alex ShulginDiscussion:https://postgr.es/m/CANaTPsrYgSgE2fuj3=4x=Jmx1c+NgkEDzftNknZbrMuqL+aBhQ@mail.gmail.com

1 parent34a0a81 commite0ed681Copy full SHA for e0ed681

File tree

-4

lines changed

-4

lines changed

Lines changed: 9 additions & 4 deletions

Original file line number	Diff line number	Diff line change
`@@ -925,10 +925,15 @@ postgresql:///mydb?host=localhost&port=5433`
`925`	`925`	`</para>`
`926`	`926`
`927`	`927`	`<para>`
`928`		`- Percent-encoding may be used to include symbols with special meaning in any`
`929`		`- of the <acronym>URI</acronym> parts, e.g. replace <literal>=</literal> with`
`930`		`- <literal>%3D</literal>.`
`931`		`-`
	`928`	`+ Connection <acronym>URI</acronym> needs to be encoded with`
	`929`	`+ <ulink url="https://tools.ietf.org/html/rfc3986#section-2.1">Percent-encoding</ulink>`
	`930`	`+ if it includes symbols with special meaning in any of its parts.`
	`931`	`+ Here is an example where equal sign (<literal>=</literal>) is replaced`
	`932`	`+ with <literal>%3D</literal> and whitespace character with`
	`933`	`+ <literal>%20</literal>:`
	`934`	`+<programlisting>`
	`935`	`+postgresql://user@localhost:5433/mydb?options=-c%20synchronous_commit%3Doff`
	`936`	`+</programlisting>`
`932`	`937`	`</para>`
`933`	`938`
`934`	`939`	`<para>`

Comments

(0)