Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1kagth-0007X1-OD
	for pgsql-docs@arkaria.postgresql.org; Thu, 05 Nov 2020 15:09:58 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1kagtg-0002k5-85
	for pgsql-docs@arkaria.postgresql.org; Thu, 05 Nov 2020 15:09:56 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <daniel@yesql.se>)
	id 1kagtg-0002jy-0L
	for pgsql-docs@lists.postgresql.org; Thu, 05 Nov 2020 15:09:56 +0000
Received: from smtp.outgoing.loopia.se ([93.188.3.37])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <daniel@yesql.se>)
	id 1kagtc-0006yf-T0
	for pgsql-docs@lists.postgresql.org; Thu, 05 Nov 2020 15:09:55 +0000
Received: from s807.loopia.se (localhost [127.0.0.1])
	by s807.loopia.se (Postfix) with ESMTP id 260D910D5340
	for <pgsql-docs@lists.postgresql.org>; Thu,  5 Nov 2020 16:09:50 +0100 (CET)
Received: from s645.loopia.se (unknown [172.22.191.6])
	by s807.loopia.se (Postfix) with ESMTP id 075B22E6E6A4
	for <pgsql-docs@lists.postgresql.org>; Thu,  5 Nov 2020 16:09:50 +0100 (CET)
Received: from s475.loopia.se (unknown [172.22.191.6])
	by s645.loopia.se (Postfix) with ESMTP id E0961157A078
	for <pgsql-docs@lists.postgresql.org>; Thu,  5 Nov 2020 16:09:49 +0100 (CET)
X-Virus-Scanned: amavisd-new at amavis.loopia.se
X-Spam-Flag: NO
X-Spam-Score: -1
X-Spam-Level: 
X-Spam-Status: No, score=-1 tagged_above=-999 required=6.2
	tests=[ALL_TRUSTED=-1] autolearn=disabled
Received: from s500.loopia.se ([172.22.191.6])
	by s475.loopia.se (s475.loopia.se [172.22.190.15]) (amavisd-new, port 10024)
	with LMTP id YsjIT7-EEPiQ for <pgsql-docs@lists.postgresql.org>;
	Thu,  5 Nov 2020 16:09:49 +0100 (CET)
X-Loopia-Auth: user
X-Loopia-User: daniel@yesql.se
X-Loopia-Originating-IP: 89.255.232.193
Received: from [192.168.72.43] (customer-89-255-232-193.stosn.net
 [89.255.232.193])
	(Authenticated sender: daniel@yesql.se)
	by s500.loopia.se (Postfix) with ESMTPSA id 5D65D1E32F06
	for <pgsql-docs@lists.postgresql.org>; Thu,  5 Nov 2020 16:09:49 +0100 (CET)
From: Daniel Gustafsson <daniel@yesql.se>
Content-Type: multipart/mixed;
	boundary="Apple-Mail=_8782E7BC-E85A-4213-9E9A-18A7B144DEFC"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.15\))
Subject: Consistent reference to RFCs in the documentation
Message-Id: <2C697878-4D01-4F06-8312-2FEDE931E973@yesql.se>
Date: Thu, 5 Nov 2020 16:09:48 +0100
To: Pg Docs <pgsql-docs@lists.postgresql.org>
X-Mailer: Apple Mail (2.3445.104.15)
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk


--Apple-Mail=_8782E7BC-E85A-4213-9E9A-18A7B144DEFC
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii

When referencing RFC's, we have a mix of ulinking to the ietf.org entry =
and
not.  Also, for subsequent mentions of the same RFC on the same page we =
have
some as <acronym> while others are not.  The attached patch adds ulinks =
for all
RFC's and marks subsequent mentions as acronym to make the docs =
consistent.  It
also spells all as "RFC <number>" with a whitespace as that was the most
commonly used spelling (there is no RFC for how to reference to an RFC =
so we're
free to choose).

In order to make review easier I haven't fixed linelengths/wrapping, but =
am
happy to do that in case this is deemed something we want.

cheers ./daniel


--Apple-Mail=_8782E7BC-E85A-4213-9E9A-18A7B144DEFC
Content-Disposition: attachment;
	filename=0001-docs-ulink-all-references-to-RFC-s.patch
Content-Type: application/octet-stream;
	x-unix-mode=0644;
	name="0001-docs-ulink-all-references-to-RFC-s.patch"
Content-Transfer-Encoding: quoted-printable

=46rom=2077b02fee33ff4d582097f0ab449bfb939c455f22=20Mon=20Sep=2017=20=
00:00:00=202001=0AFrom:=20Daniel=20Gustafsson=20<daniel@yesql.se>=0A=
Date:=20Thu,=205=20Nov=202020=2016:00:27=20+0100=0ASubject:=20[PATCH]=20=
docs:=20ulink=20all=20references=20to=20RFC's=0A=0AMake=20sure=20that=20=
the=20first=20mentions=20of=20RFC's=20are=20ulinked=20to=20their=20=
ietf.org=0Aentry,=20and=20subsequent=20ones=20are=20marked=20as=20=
acronyms.=20This=20makes=20references=0Ato=20RFC's=20consistent=20across=20=
the=20documentation.=0A---=0A=20doc/src/sgml/catalogs.sgml=20=20=20=20|=20=
=202=20+-=0A=20doc/src/sgml/charset.sgml=20=20=20=20=20|=20=202=20+-=0A=20=
doc/src/sgml/client-auth.sgml=20|=2012=20++++++------=0A=20=
doc/src/sgml/datatype.sgml=20=20=20=20|=20=204=20++--=0A=20=
doc/src/sgml/ecpg.sgml=20=20=20=20=20=20=20=20|=20=202=20+-=0A=20=
doc/src/sgml/func.sgml=20=20=20=20=20=20=20=20|=20=202=20+-=0A=20=
doc/src/sgml/json.sgml=20=20=20=20=20=20=20=20|=20=204=20++--=0A=20=
doc/src/sgml/libpq.sgml=20=20=20=20=20=20=20|=20=202=20+-=0A=20=
doc/src/sgml/pgcrypto.sgml=20=20=20=20|=20=206=20+++---=0A=20=
doc/src/sgml/protocol.sgml=20=20=20=20|=20=204=20++--=0A=20=
doc/src/sgml/textsearch.sgml=20=20|=20=202=20+-=0A=20=
doc/src/sgml/uuid-ossp.sgml=20=20=20|=20=204=20++--=0A=2012=20files=20=
changed,=2023=20insertions(+),=2023=20deletions(-)=0A=0Adiff=20--git=20=
a/doc/src/sgml/catalogs.sgml=20b/doc/src/sgml/catalogs.sgml=0Aindex=20=
5fb9dca425..15b8374822=20100644=0A---=20a/doc/src/sgml/catalogs.sgml=0A=
+++=20b/doc/src/sgml/catalogs.sgml=0A@@=20-1598,7=20+1598,7=20@@=20=
SCRAM-SHA-256$<replaceable>&lt;iteration=20=
count&gt;</replaceable>:<replaceable>&l=0A=20</synopsis>=0A=20=20=20=20=
where=20<replaceable>salt</replaceable>,=20=
<replaceable>StoredKey</replaceable>=20and=0A=20=20=20=20=
<replaceable>ServerKey</replaceable>=20are=20in=20Base64=20encoded=20=
format.=20This=20format=20is=0A-=20=20=20the=20same=20as=20that=20=
specified=20by=20RFC=205803.=0A+=20=20=20the=20same=20as=20that=20=
specified=20by=20<ulink=20url=3D"https://tools.ietf.org/html/rfc5803">RFC=20=
5803</ulink>.=0A=20=20=20</para>=0A=20=0A=20=20=20<para>=0Adiff=20--git=20=
a/doc/src/sgml/charset.sgml=20b/doc/src/sgml/charset.sgml=0Aindex=20=
832a701523..d744267785=20100644=0A---=20a/doc/src/sgml/charset.sgml=0A=
+++=20b/doc/src/sgml/charset.sgml=0A@@=20-2662,7=20+2662,7=20@@=20RESET=20=
client_encoding;=0A=20=20=20=20=20=20=20</varlistentry>=0A=20=0A=20=20=20=
=20=20=20=20<varlistentry>=0A-=20=20=20=20=20=20=20<term>RFC=20=
3629</term>=0A+=20=20=20=20=20=20=20<term><ulink=20=
url=3D"https://tools.ietf.org/html/rfc3629">RFC=203629</ulink></term>=0A=20=
=0A=20=20=20=20=20=20=20=20<listitem>=0A=20=20=20=20=20=20=20=20=20=
<para>=0Adiff=20--git=20a/doc/src/sgml/client-auth.sgml=20=
b/doc/src/sgml/client-auth.sgml=0Aindex=20bad3c3469c..502b76815f=20=
100644=0A---=20a/doc/src/sgml/client-auth.sgml=0A+++=20=
b/doc/src/sgml/client-auth.sgml=0A@@=20-948,7=20+948,7=20@@=20omicron=20=20=
=20=20=20=20=20=20=20bryanh=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=
=20=20guest1=0A=20=20=20=20=20<listitem>=0A=20=20=20=20=20=20<para>=0A=20=
=20=20=20=20=20=20<link=20linkend=3D"auth-ident">Ident=20=
authentication</link>,=20which=0A-=20=20=20=20=20=20relies=20on=20an=20=
<quote>Identification=20Protocol</quote>=20(RFC=201413)=0A+=20=20=20=20=20=
=20relies=20on=20an=20<quote>Identification=20Protocol</quote>=20(<ulink=20=
url=3D"https://tools.ietf.org/html/rfc1413">RFC=201413</ulink>)=0A=20=20=20=
=20=20=20=20service=20on=20the=20client's=20machine.=20=20(On=20local=20=
Unix-socket=20connections,=0A=20=20=20=20=20=20=20this=20is=20treated=20=
as=20peer=20authentication.)=0A=20=20=20=20=20=20</para>=0A@@=20-1198,7=20=
+1198,7=20@@=20omicron=20=20=20=20=20=20=20=20=20bryanh=20=20=20=20=20=20=
=20=20=20=20=20=20=20=20=20=20=20=20guest1=0A=20=0A=20=20=20=20<para>=0A=20=
=20=20=20=20<productname>GSSAPI</productname>=20is=20an=20=
industry-standard=20protocol=0A-=20=20=20=20for=20secure=20=
authentication=20defined=20in=20RFC=202743.=0A+=20=20=20=20for=20secure=20=
authentication=20defined=20in=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc2743">RFC=202743</ulink>.=0A=20=0A=20=
=20=20=20=20<productname>PostgreSQL</productname>=0A=20=20=20=20=20=
supports=20<productname>GSSAPI</productname>=20for=20use=20as=20either=20=
an=20encrypted,=0A@@=20-1503,7=20+1503,7=20@@=20omicron=20=20=20=20=20=20=
=20=20=20bryanh=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=
guest1=0A=20=0A=20=20=20=20<para>=0A=20=20=20=20=20The=20=
<quote>Identification=20Protocol</quote>=20is=20described=20in=0A-=20=20=20=
=20RFC=201413.=20Virtually=20every=20Unix-like=0A+=20=20=20=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc1413">RFC=201413</ulink>.=20=
Virtually=20every=20Unix-like=0A=20=20=20=20=20operating=20system=20=
ships=20with=20an=20ident=20server=20that=20listens=20on=20TCP=0A=20=20=20=
=20=20port=20113=20by=20default.=20The=20basic=20functionality=20of=20an=20=
ident=20server=0A=20=20=20=20=20is=20to=20answer=20questions=20like=20=
<quote>What=20user=20initiated=20the=0A@@=20-1671,7=20+1671,7=20@@=20=
omicron=20=20=20=20=20=20=20=20=20bryanh=20=20=20=20=20=20=20=20=20=20=20=
=20=20=20=20=20=20=20guest1=0A=20=20=20=20=20=20=20=20<para>=0A=20=20=20=20=
=20=20=20=20=20Set=20to=201=20to=20make=20the=20connection=20between=20=
PostgreSQL=20and=20the=20LDAP=20server=0A=20=20=20=20=20=20=20=20=20use=20=
TLS=20encryption.=20=20This=20uses=20the=20<literal>StartTLS</literal>=0A=
-=20=20=20=20=20=20=20=20operation=20per=20RFC=204513.=20=20See=20also=20=
the=20<literal>ldapscheme</literal>=0A+=20=20=20=20=20=20=20=20operation=20=
per=20<ulink=20url=3D"https://tools.ietf.org/html/rfc4513">RFC=20=
4513</ulink>.=20=20See=20also=20the=20<literal>ldapscheme</literal>=0A=20=
=20=20=20=20=20=20=20=20option=20for=20an=20alternative.=0A=20=20=20=20=20=
=20=20=20</para>=0A=20=20=20=20=20=20=20</listitem>=0A@@=20-1766,7=20=
+1766,7=20@@=20omicron=20=20=20=20=20=20=20=20=20bryanh=20=20=20=20=20=20=
=20=20=20=20=20=20=20=20=20=20=20=20guest1=0A=20=20=20=20=20=20=20=20=
<term><literal>ldapurl</literal></term>=0A=20=20=20=20=20=20=20=20=
<listitem>=0A=20=20=20=20=20=20=20=20=20<para>=0A-=20=20=20=20=20=20=20=20=
=20An=20RFC=204516=20LDAP=20URL.=20=20This=20is=20an=20alternative=20way=20=
to=20write=20some=20of=20the=0A+=20=20=20=20=20=20=20=20=20An=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc4516">RFC=204516</ulink>=20LDAP=20=
URL.=20=20This=20is=20an=20alternative=20way=20to=20write=20some=20of=20=
the=0A=20=20=20=20=20=20=20=20=20=20other=20LDAP=20options=20in=20a=20=
more=20compact=20and=20standard=20form.=20=20The=20format=20is=0A=20=
<synopsis>=0A=20=
ldap[s]://<replaceable>host</replaceable>[:<replaceable>port</replaceable>=
]/<replaceable>basedn</replaceable>[?[<replaceable>attribute</replaceable>=
][?[<replaceable>scope</replaceable>][?[<replaceable>filter</replaceable>]=
]]]=0A@@=20-1827,7=20+1827,7=20@@=20=
ldap[s]://<replaceable>host</replaceable>[:<replaceable>port</replaceable>=
]/<rep=0A=20=20=20=20=20=20If=20<productname>PostgreSQL</productname>=20=
was=20compiled=20with=0A=20=20=20=20=20=20=
<productname>OpenLDAP</productname>=20as=20the=20LDAP=20client=20=
library,=20the=0A=20=20=20=20=20=20<literal>ldapserver</literal>=20=
setting=20may=20be=20omitted.=20=20In=20that=20case,=20a=0A-=20=20=20=20=20=
list=20of=20host=20names=20and=20ports=20is=20looked=20up=20via=20RFC=20=
2782=20DNS=20SRV=20records.=0A+=20=20=20=20=20list=20of=20host=20names=20=
and=20ports=20is=20looked=20up=20via=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc2782">RFC=202782</ulink>=20DNS=20=
SRV=20records.=0A=20=20=20=20=20=20The=20name=20=
<literal>_ldap._tcp.DOMAIN</literal>=20is=20looked=20up,=20where=0A=20=20=
=20=20=20=20<literal>DOMAIN</literal>=20is=20extracted=20from=20=
<literal>ldapbasedn</literal>.=0A=20=20=20=20</para>=0Adiff=20--git=20=
a/doc/src/sgml/datatype.sgml=20b/doc/src/sgml/datatype.sgml=0Aindex=20=
c2951854b5..6667b69189=20100644=0A---=20a/doc/src/sgml/datatype.sgml=0A=
+++=20b/doc/src/sgml/datatype.sgml=0A@@=20-2384,7=20+2384,7=20@@=20=
TIMESTAMP=20WITH=20TIME=20ZONE=20'2004-10-19=2010:23:54+02'=0A=20=20=20=20=
=20=20=20ISO=208601=20specifies=20the=20use=20of=20uppercase=20letter=20=
<literal>T</literal>=20to=20separate=0A=20=20=20=20=20=20=20the=20date=20=
and=20time.=20=20<productname>PostgreSQL</productname>=20accepts=20that=20=
format=20on=0A=20=20=20=20=20=20=20input,=20but=20on=20output=20it=20=
uses=20a=20space=20rather=20than=20<literal>T</literal>,=20as=20shown=0A=
-=20=20=20=20=20=20above.=20=20This=20is=20for=20readability=20and=20for=20=
consistency=20with=20RFC=203339=20as=0A+=20=20=20=20=20=20above.=20=20=
This=20is=20for=20readability=20and=20for=20consistency=20with=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc3339">RFC=203339</ulink>=20as=0A=20=
=20=20=20=20=20=20well=20as=20some=20other=20database=20systems.=0A=20=20=
=20=20=20=20</para>=0A=20=20=20=20=20</note>=0A@@=20-4247,7=20+4247,7=20=
@@=20SELECT=20to_tsvector(=20'postgraduate'=20),=20to_tsquery(=20=
'postgres:*'=20);=0A=20=0A=20=20=20=20<para>=0A=20=20=20=20=20The=20data=20=
type=20<type>uuid</type>=20stores=20Universally=20Unique=20Identifiers=0A=
-=20=20=20=20(UUID)=20as=20defined=20by=20RFC=204122,=20ISO/IEC=20=
9834-8:2005,=20and=20related=20standards.=0A+=20=20=20=20(UUID)=20as=20=
defined=20by=20<ulink=20url=3D"https://tools.ietf.org/html/rfc4122">RFC=20=
4122</ulink>,=20ISO/IEC=209834-8:2005,=20and=20related=20standards.=0A=20=
=20=20=20=20(Some=20systems=20refer=20to=20this=20data=20type=20as=20a=20=
globally=20unique=20identifier,=20or=0A=20=20=20=20=20=
GUID,<indexterm><primary>GUID</primary></indexterm>=20instead.)=20=20=
This=0A=20=20=20=20=20identifier=20is=20a=20128-bit=20quantity=20that=20=
is=20generated=20by=20an=20algorithm=20chosen=0Adiff=20--git=20=
a/doc/src/sgml/ecpg.sgml=20b/doc/src/sgml/ecpg.sgml=0Aindex=20=
14dcbdb4e3..0fef9bfcbe=20100644=0A---=20a/doc/src/sgml/ecpg.sgml=0A+++=20=
b/doc/src/sgml/ecpg.sgml=0A@@=20-3226,7=20+3226,7=20@@=20int=20=
PGTYPEStimestamp_fmt_asc(timestamp=20*ts,=20char=20*output,=20int=20=
str_len,=20char=20*fmt=0A=20=20=20=20=20=20=20=20=20=20=20=20=
<literal>%z</literal>=20-=20is=20replaced=20by=20the=20time=20zone=20=
offset=20from=0A=20=20=20=20=20=20=20=20=20=20=20=20UTC;=20a=20leading=20=
plus=20sign=20stands=20for=20east=20of=20UTC,=20a=20minus=20sign=20for=0A=
=20=20=20=20=20=20=20=20=20=20=20=20west=20of=20UTC,=20hours=20and=20=
minutes=20follow=20with=20two=20digits=20each=20and=20no=0A-=20=20=20=20=20=
=20=20=20=20=20=20delimiter=20between=20them=20(common=20form=20for=20=
RFC=20822=20date=20headers).=0A+=20=20=20=20=20=20=20=20=20=20=20=
delimiter=20between=20them=20(common=20form=20for=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc822">RFC=20822</ulink>=20date=20=
headers).=0A=20=20=20=20=20=20=20=20=20=20=20</para>=0A=20=20=20=20=20=20=
=20=20=20=20</listitem>=0A=20=20=20=20=20=20=20=20=20=20<listitem>=0A=
diff=20--git=20a/doc/src/sgml/func.sgml=20b/doc/src/sgml/func.sgml=0A=
index=2087a6ba8d10..659d708ea1=20100644=0A---=20a/doc/src/sgml/func.sgml=0A=
+++=20b/doc/src/sgml/func.sgml=0A@@=20-4466,7=20+4466,7=20@@=20SELECT=20=
format('Testing=20%3$s,=20%2$s,=20%s',=20'one',=20'two',=20'three');=0A=20=
=20=20=20=20=20=20<para>=0A=20=20=20=20=20=20=20=20The=20=
<literal>base64</literal>=20format=20is=20that=0A=20=20=20=20=20=20=20=20=
of=20<ulink=20url=3D"https://tools.ietf.org/html/rfc2045#section-6.8">RFC=0A=
-=20=20=20=20=20=20=202045=20Section=206.8</ulink>.=20=20As=20per=20the=20=
RFC,=20encoded=20lines=20are=0A+=20=20=20=20=20=20=202045=20Section=20=
6.8</ulink>.=20=20As=20per=20the=20<acronym>RFC</acronym>,=20encoded=20=
lines=20are=0A=20=20=20=20=20=20=20=20broken=20at=2076=20characters.=20=20=
However=20instead=20of=20the=20MIME=20CRLF=0A=20=20=20=20=20=20=20=20=
end-of-line=20marker,=20only=20a=20newline=20is=20used=20for=20=
end-of-line.=0A=20=20=20=20=20=20=20=20The=20<function>decode</function>=20=
function=20ignores=20carriage-return,=0Adiff=20--git=20=
a/doc/src/sgml/json.sgml=20b/doc/src/sgml/json.sgml=0Aindex=20=
c0a6554d4d..5b9a5557a4=20100644=0A---=20a/doc/src/sgml/json.sgml=0A+++=20=
b/doc/src/sgml/json.sgml=0A@@=20-61,7=20+61,7=20@@=0A=20=20</para>=0A=20=0A=
=20=20<para>=0A-=20=20RFC=207159=20specifies=20that=20JSON=20strings=20=
should=20be=20encoded=20in=20UTF8.=0A+=20=20<acronym>RFC</acronym>=20=
7159=20specifies=20that=20JSON=20strings=20should=20be=20encoded=20in=20=
UTF8.=0A=20=20=20It=20is=20therefore=20not=20possible=20for=20the=20JSON=0A=
=20=20=20types=20to=20conform=20rigidly=20to=20the=20JSON=20=
specification=20unless=20the=20database=0A=20=20=20encoding=20is=20UTF8.=20=
Attempts=20to=20directly=20include=20characters=20that=0A@@=20-71,7=20=
+71,7=20@@=0A=20=20</para>=0A=20=0A=20=20<para>=0A-=20=20RFC=207159=20=
permits=20JSON=20strings=20to=20contain=20Unicode=20escape=20sequences=0A=
+=20=20<acronym>RFC</acronym>=207159=20permits=20JSON=20strings=20to=20=
contain=20Unicode=20escape=20sequences=0A=20=20=20denoted=20by=20=
<literal>\u<replaceable>XXXX</replaceable></literal>.=20=20In=20the=20=
input=0A=20=20=20function=20for=20the=20<type>json</type>=20type,=20=
Unicode=20escapes=20are=20allowed=0A=20=20=20regardless=20of=20the=20=
database=20encoding,=20and=20are=20checked=20only=20for=20syntactic=0A=
diff=20--git=20a/doc/src/sgml/libpq.sgml=20b/doc/src/sgml/libpq.sgml=0A=
index=209ce32fb39b..4e1d052502=20100644=0A---=20=
a/doc/src/sgml/libpq.sgml=0A+++=20b/doc/src/sgml/libpq.sgml=0A@@=20=
-7447,7=20+7447,7=20@@=20user=3Dadmin=0A=20=20=20=20=
<literal>ldap://</literal>=20will=20be=20recognized=20as=20an=20LDAP=20=
URL=20and=20an=0A=20=20=20=20LDAP=20query=20will=20be=20performed.=20The=20=
result=20must=20be=20a=20list=20of=0A=20=20=20=20<literal>keyword=20=3D=20=
value</literal>=20pairs=20which=20will=20be=20used=20to=20set=0A-=20=20=20=
connection=20options.=20=20The=20URL=20must=20conform=20to=20RFC=201959=20=
and=20be=20of=20the=0A+=20=20=20connection=20options.=20=20The=20URL=20=
must=20conform=20to=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc1959">RFC=201959</ulink>=20and=20=
be=20of=20the=0A=20=20=20=20form=0A=20<synopsis>=0A=20=
ldap://[<replaceable>hostname</replaceable>[:<replaceable>port</replaceabl=
e>]]/<replaceable>search_base</replaceable>?<replaceable>attribute</replac=
eable>?<replaceable>search_scope</replaceable>?<replaceable>filter</replac=
eable>=0Adiff=20--git=20a/doc/src/sgml/pgcrypto.sgml=20=
b/doc/src/sgml/pgcrypto.sgml=0Aindex=208748c64e2d..f5ca0c820b=20100644=0A=
---=20a/doc/src/sgml/pgcrypto.sgml=0A+++=20b/doc/src/sgml/pgcrypto.sgml=0A=
@@=20-437,7=20+437,7=20@@=20gen_salt(type=20text=20[,=20iter_count=20=
integer=20])=20returns=20text=0A=20=20=20<title>PGP=20Encryption=20=
Functions</title>=0A=20=0A=20=20=20<para>=0A-=20=20=20The=20functions=20=
here=20implement=20the=20encryption=20part=20of=20the=20OpenPGP=20(RFC=20=
4880)=0A+=20=20=20The=20functions=20here=20implement=20the=20encryption=20=
part=20of=20the=20OpenPGP=20(<ulink=20=
url=3D"https://tools.ietf.org/html/rfc4880">RFC=204880</ulink>)=0A=20=20=20=
=20standard.=20=20Supported=20are=20both=20symmetric-key=20and=20=
public-key=20encryption.=0A=20=20=20</para>=0A=20=0A@@=20-806,7=20+806,7=20=
@@=20Applies=20to:=20pgp_sym_encrypt,=20pgp_pub_encrypt=0A=20=20=20=20=
<para>=0A=20=20=20=20=20Whether=20to=20convert=20<literal>\n</literal>=20=
into=20<literal>\r\n</literal>=20when=0A=20=20=20=20=20encrypting=20and=20=
<literal>\r\n</literal>=20to=20<literal>\n</literal>=20when=0A-=20=20=20=20=
decrypting.=20=20RFC=204880=20specifies=20that=20text=20data=20should=20=
be=20stored=20using=0A+=20=20=20=20decrypting.=20=20=
<acronym>RFC</acronym>=204880=20specifies=20that=20text=20data=20should=20=
be=20stored=20using=0A=20=20=20=20=20<literal>\r\n</literal>=20=
line-feeds.=20=20Use=20this=20to=20get=20fully=20RFC-compliant=0A=20=20=20=
=20=20behavior.=0A=20=20=20=20</para>=0A@@=20-823,7=20+823,7=20@@=20=
Applies=20to:=20pgp_sym_encrypt,=20pgp_pub_encrypt,=20pgp_sym_decrypt,=20=
pgp_pub_decrypt=0A=20=20=20=20<para>=0A=20=20=20=20=20Do=20not=20protect=20=
data=20with=20SHA-1.=20=20The=20only=20good=20reason=20to=20use=20this=0A=
=20=20=20=20=20option=20is=20to=20achieve=20compatibility=20with=20=
ancient=20PGP=20products,=20predating=0A-=20=20=20=20the=20addition=20of=20=
SHA-1=20protected=20packets=20to=20RFC=204880.=0A+=20=20=20=20the=20=
addition=20of=20SHA-1=20protected=20packets=20to=20=
<acronym>RFC</acronym>=204880.=0A=20=20=20=20=20Recent=20gnupg.org=20and=20=
pgp.com=20software=20supports=20it=20fine.=0A=20=20=20=20</para>=0A=20=
<literallayout>=0Adiff=20--git=20a/doc/src/sgml/protocol.sgml=20=
b/doc/src/sgml/protocol.sgml=0Aindex=209a95d7b734..eca1299cbd=20100644=0A=
---=20a/doc/src/sgml/protocol.sgml=0A+++=20b/doc/src/sgml/protocol.sgml=0A=
@@=20-1501,7=20+1501,7=20@@=20SELCT=201/0;<!--=20this=20typo=20is=20=
intentional=20-->=0A=20=20=20=20=20is=20willing=20or=20unwilling=20to=20=
perform=20<acronym>GSSAPI</acronym>=20encryption,=0A=20=20=20=20=20=
respectively.=20=20The=20frontend=20might=20close=20the=20connection=20=
at=20this=20point=0A=20=20=20=20=20if=20it=20is=20dissatisfied=20with=20=
the=20response.=20=20To=20continue=20after=0A-=20=20=20=20=
<literal>G</literal>,=20using=20the=20GSSAPI=20C=20bindings=20as=20=
discussed=20in=20RFC2744=0A+=20=20=20=20<literal>G</literal>,=20using=20=
the=20GSSAPI=20C=20bindings=20as=20discussed=20in=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc2744">RFC=202744</ulink>=0A=20=20=20=
=20=20or=20equivalent,=20perform=20a=20<acronym>GSSAPI</acronym>=20=
initialization=20by=0A=20=20=20=20=20calling=20=
<function>gss_init_sec_context()</function>=20in=20a=20loop=20and=20=
sending=0A=20=20=20=20=20the=20result=20to=20the=20server,=20starting=20=
with=20an=20empty=20input=20and=20then=20with=20each=0A@@=20-1616,7=20=
+1616,7=20@@=20ErrorMessage.=0A=20=20=20=20The=20implemented=20SASL=20=
mechanisms=20at=20the=20moment=0A=20=20=20=20are=20=
<literal>SCRAM-SHA-256</literal>=20and=20its=20variant=20with=20channel=0A=
=20=20=20=20binding=20<literal>SCRAM-SHA-256-PLUS</literal>.=20They=20=
are=20described=20in=0A-=20=20=20detail=20in=20RFC=207677=20and=20RFC=20=
5802.=0A+=20=20=20detail=20in=20<ulink=20=
url=3D"https://tools.ietf.org/html/rfc7677">RFC=207677</ulink>=20and=20=
<ulink=20url=3D"https://tools.ietf.org/html/rfc5802">RFC=205802</ulink>.=0A=
=20=20=20</para>=0A=20=0A=20=20=20<para>=0Adiff=20--git=20=
a/doc/src/sgml/textsearch.sgml=20b/doc/src/sgml/textsearch.sgml=0Aindex=20=
7bd8d53dc4..aa00a2139a=20100644=0A---=20a/doc/src/sgml/textsearch.sgml=0A=
+++=20b/doc/src/sgml/textsearch.sgml=0A@@=20-2218,7=20+2218,7=20@@=20=
LIMIT=2010;=0A=20=0A=20=20=20=20<para>=0A=20=20=20=20=20=
<literal>email</literal>=20does=20not=20support=20all=20valid=20email=20=
characters=20as=0A-=20=20=20=20defined=20by=20RFC=205322.=20=20=
Specifically,=20the=20only=20non-alphanumeric=0A+=20=20=20=20defined=20=
by=20<ulink=20url=3D"https://tools.ietf.org/html/rfc5322">RFC=20=
5322</ulink>.=20=20Specifically,=20the=20only=20non-alphanumeric=0A=20=20=
=20=20=20characters=20supported=20for=20email=20user=20names=20are=20=
period,=20dash,=20and=0A=20=20=20=20=20underscore.=0A=20=20=20=20</para>=0A=
diff=20--git=20a/doc/src/sgml/uuid-ossp.sgml=20=
b/doc/src/sgml/uuid-ossp.sgml=0Aindex=20460be97fdd..d4dd678f67=20100644=0A=
---=20a/doc/src/sgml/uuid-ossp.sgml=0A+++=20=
b/doc/src/sgml/uuid-ossp.sgml=0A@@=20-28,8=20+28,8=20@@=0A=20=20=20=
<para>=0A=20=20=20=20<xref=20linkend=3D"uuid-ossp-functions"/>=20shows=20=
the=20functions=20available=20to=0A=20=20=20=20generate=20UUIDs.=0A-=20=20=
=20The=20relevant=20standards=20ITU-T=20Rec.=20X.667,=20ISO/IEC=20=
9834-8:2005,=20and=20RFC=0A-=20=20=204122=20specify=20four=20algorithms=20=
for=20generating=20UUIDs,=20identified=20by=20the=0A+=20=20=20The=20=
relevant=20standards=20ITU-T=20Rec.=20X.667,=20ISO/IEC=209834-8:2005,=20=
and=20<ulink=20url=3D"https://tools.ietf.org/html/rfc4122">RFC=0A+=20=20=20=
4122</ulink>=20specify=20four=20algorithms=20for=20generating=20UUIDs,=20=
identified=20by=20the=0A=20=20=20=20version=20numbers=201,=203,=204,=20=
and=205.=20=20(There=20is=20no=20version=202=20algorithm.)=0A=20=20=20=20=
Each=20of=20these=20algorithms=20could=20be=20suitable=20for=20a=20=
different=20set=20of=0A=20=20=20=20applications.=0A--=20=0A2.21.1=20=
(Apple=20Git-122.3)=0A=0A=

--Apple-Mail=_8782E7BC-E85A-4213-9E9A-18A7B144DEFC--