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 1oOc74-0007Jr-Pa
	for pgsql-docs@arkaria.postgresql.org; Thu, 18 Aug 2022 09:46:55 +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 1oOc71-0005wJ-Vw
	for pgsql-docs@arkaria.postgresql.org; Thu, 18 Aug 2022 09:46:51 +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 <m.yablokov@postgrespro.ru>)
	id 1oOc71-0005w9-GW
	for pgsql-docs@lists.postgresql.org; Thu, 18 Aug 2022 09:46:51 +0000
Received: from mail.postgrespro.ru ([93.174.131.139])
	by magus.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <m.yablokov@postgrespro.ru>)
	id 1oOc6z-0007ur-3i
	for pgsql-docs@lists.postgresql.org; Thu, 18 Aug 2022 09:46:50 +0000
Received: from [192.168.28.47] (cyclops.postgrespro.ru [93.174.131.138])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(Client did not present a certificate)
	by mail.postgrespro.ru (Postfix) with ESMTPSA id 093AB21C2D9D;
	Thu, 18 Aug 2022 12:46:46 +0300 (MSK)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=postgrespro.ru;
	s=mail; t=1660816007;
	bh=9Oi9YF1HUijW49lm6dpA0gpXwsgzjBuj1s5PIbUtEcA=;
	h=Date:From:Subject:To:References:Cc:In-Reply-To;
	b=PAXA1ll5c5jF/cJSuUZYrQVcgtYvQV34j8XSdxQwGMYFmdYC4v4L8oo5FGqgCM6kL
	 CVy43tsp/HNE07xcdZqP9BsXSDDAdsximFnA0Boq4Qk40HKGzILumVU43rSjCSVrbu
	 gqflp4TQWVIs3dPbK+rcJD6VW7WgUi0bEJ2/sNrc=
Content-Type: multipart/mixed; boundary="------------USarlNgcw4YxQHeS9TmbW1tH"
Message-ID: <19da1e0e-94b7-469c-4334-75ebad79c261@postgrespro.ru>
Date: Thu, 18 Aug 2022 12:46:41 +0300
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101
 Thunderbird/91.11.0
From: Maxim Yablokov <m.yablokov@postgrespro.ru>
Subject: Re: PostgreSQL 15 minor documentation improvements
To: Michael Paquier <michael@paquier.xyz>
References: <c7aaa1ba-c31d-0a00-600f-27d0e4f069db@postgrespro.ru>
Content-Language: en-US
Cc: pgsql-docs@lists.postgresql.org
Organization: Postgres Professional
In-Reply-To: <c7aaa1ba-c31d-0a00-600f-27d0e4f069db@postgrespro.ru>
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>
Archived-At: 
 <https://www.postgresql.org/message-id/19da1e0e-94b7-469c-4334-75ebad79c261%40postgrespro.ru>
Precedence: bulk

This is a multi-part message in MIME format.
--------------USarlNgcw4YxQHeS9TmbW1tH
Content-Type: multipart/alternative;
 boundary="------------e6PNPcohQcA0OmYmIWDrdgJk"

--------------e6PNPcohQcA0OmYmIWDrdgJk
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

On Wed, Aug 17, 2022 at 06:09:13PM +0300, Максим Яблоков wrote:
>> I have prepared a small patch with possible changes of these places, and
>> also a separate patch with some improvements concerning missed/inapt tags.
>> Please have a look.
> archive_command is used only when archive_library is not set AFAIK,
> but an archive_library could also freely use an archive_command if it
> wishes to.  But, yes, I agree that the current wording in backup.sgml
> is kind of confusing because of this reason, so I am fine to have a
> reference to both archive_library *and* archive_command in this area
> of the docs.
>
>       All WAL records required for the backup must contain sufficient full-page writes,
>       which requires you to enable <varname>full_page_writes</varname> on the primary and
> -    not to use a tool in your <varname>archive_library</varname> to remove
> -    full-page writes from WAL files.
> +    not to use a tool to remove full-page writes from WAL files.
>
> Hmm.  My opinion here is to do a simplification, and remove simply the
> last part of the paragraph about tools that manipulate WAL files
> as the first sentence makes it clear, in my opinion, that if those
> FPWs are not around the server could become kaput.
Thanks, new patch is attached.
> Most of the changes in PGSQL15_tags_fix.patch seem right to me.
> Still, you'd better check that the docs compile, as of:
>
>> --- a/doc/src/sgml/basebackup-to-shell.sgml
>> +++ b/doc/src/sgml/basebackup-to-shell.sgml
>> @@ -12,9 +12,9 @@
>>     called <literal>shell</literal>. This makes it possible to run
>>     <literal>pg_basebackup --target=shell</literal> or, depending on how this
>>     module is configured,
>> -  <literal>pg_basebackup --target=shell:DETAIL_STRING</literal>, and cause
>> -  a server command chosen by the server administrator to be executed for
>> -  each tar archive generated by the backup process. The command will receive
>> +  <literal>pg_basebackup --target=shell:<replaceable>DETAIL_STRING<replaceable></literal>,
> I am pretty sure that this line is going to cause a compilation
> failure of the docs.  Anyway, this should be use a <command> markup,
> no?
Yeah, sorry about that, I fixed it in the new patch.
As for the <command> tag, it is written above:
<literal>pg_basebackup --target=shell</literal>
And also in backup.sgml there is the following:
  <literal>createdb -T template0 <replaceable 
class="parameter">dbname</replaceable></literal>
So I believe that we can keep <literal> here.

Thanks a lot!
> --
> Michael
-- 
Best regards,
Maxim Yablokov
Technical writer-translator
Postgres Professional <https://postgrespro.com/>
--------------e6PNPcohQcA0OmYmIWDrdgJk
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 8bit

<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <div class="moz-forward-container">On Wed, Aug 17, 2022 at
      06:09:13PM +0300, Максим Яблоков wrote:
      <blockquote type="cite" cite="mid:Yv22Y1k337qWLb2g@paquier.xyz">
        <blockquote type="cite">
          <pre class="moz-quote-pre" wrap="">I have prepared a small patch with possible changes of these places, and
also a separate patch with some improvements concerning missed/inapt tags.
Please have a look.
</pre>
        </blockquote>
        <pre class="moz-quote-pre" wrap="">archive_command is used only when archive_library is not set AFAIK,
but an archive_library could also freely use an archive_command if it
wishes to.  But, yes, I agree that the current wording in backup.sgml
is kind of confusing because of this reason, so I am fine to have a
reference to both archive_library *and* archive_command in this area
of the docs.

     All WAL records required for the backup must contain sufficient full-page writes,
     which requires you to enable &lt;varname&gt;full_page_writes&lt;/varname&gt; on the primary and
-    not to use a tool in your &lt;varname&gt;archive_library&lt;/varname&gt; to remove
-    full-page writes from WAL files.
+    not to use a tool to remove full-page writes from WAL files.

Hmm.  My opinion here is to do a simplification, and remove simply the
last part of the paragraph about tools that manipulate WAL files
as the first sentence makes it clear, in my opinion, that if those
FPWs are not around the server could become kaput.</pre>
      </blockquote>
      Thanks, new patch is attached.<br>
      <blockquote type="cite" cite="mid:Yv22Y1k337qWLb2g@paquier.xyz">
        <pre class="moz-quote-pre" wrap="">Most of the changes in PGSQL15_tags_fix.patch seem right to me.
Still, you'd better check that the docs compile, as of:

</pre>
        <blockquote type="cite">
          <pre class="moz-quote-pre" wrap="">--- a/doc/src/sgml/basebackup-to-shell.sgml
+++ b/doc/src/sgml/basebackup-to-shell.sgml
@@ -12,9 +12,9 @@
   called &lt;literal&gt;shell&lt;/literal&gt;. This makes it possible to run
   &lt;literal&gt;pg_basebackup --target=shell&lt;/literal&gt; or, depending on how this
   module is configured,
-  &lt;literal&gt;pg_basebackup --target=shell:DETAIL_STRING&lt;/literal&gt;, and cause
-  a server command chosen by the server administrator to be executed for
-  each tar archive generated by the backup process. The command will receive
+  &lt;literal&gt;pg_basebackup --target=shell:&lt;replaceable&gt;DETAIL_STRING&lt;replaceable&gt;&lt;/literal&gt;,
</pre>
        </blockquote>
        <pre class="moz-quote-pre" wrap="">I am pretty sure that this line is going to cause a compilation
failure of the docs.  Anyway, this should be use a &lt;command&gt; markup,
no?</pre>
      </blockquote>
      Yeah, sorry about that, I fixed it in the new patch.<br>
      As for the &lt;command&gt; tag, it is written above:<br>
      &lt;literal&gt;pg_basebackup --target=shell&lt;/literal&gt;<br>
      And also in backup.sgml there is the following:<br>
       &lt;literal&gt;createdb -T template0 &lt;replaceable
      class="parameter"&gt;dbname&lt;/replaceable&gt;&lt;/literal&gt;<br>
      So I believe that we can keep &lt;literal&gt; here.<br>
      <br>
      Thanks a lot!<br>
      <blockquote type="cite" cite="mid:Yv22Y1k337qWLb2g@paquier.xyz">
        <pre class="moz-quote-pre" wrap="">--
Michael
</pre>
      </blockquote>
      <div class="moz-signature">-- <br>
        Best regards,<br>
        Maxim Yablokov<br>
        Technical writer-translator<br>
        <a href="https://postgrespro.com/" moz-do-not-send="true">Postgres
          Professional</a></div>
    </div>
  </body>
</html>

--------------e6PNPcohQcA0OmYmIWDrdgJk--

--------------USarlNgcw4YxQHeS9TmbW1tH
Content-Type: text/x-patch; charset=UTF-8; name="PGSQL15_archive_fix2.patch"
Content-Disposition: attachment; filename="PGSQL15_archive_fix2.patch"
Content-Transfer-Encoding: base64

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9iYWNrdXAuc2dtbCBiL2RvYy9zcmMvc2dtbC9i
YWNrdXAuc2dtbAppbmRleCA3M2E3NzRkM2Q3Zi4uMmE2NGY2MDFmZmUgMTAwNjQ0Ci0tLSBh
L2RvYy9zcmMvc2dtbC9iYWNrdXAuc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwvYmFja3VwLnNn
bWwKQEAgLTk0NSwxMSArOTQ1LDExIEBAIFNFTEVDVCAqIEZST00gcGdfYmFja3VwX3N0b3Ao
d2FpdF9mb3JfYXJjaGl2ZSA9PiB0cnVlKTsKICAgICAgT24gYSBzdGFuZGJ5LCA8dmFybmFt
ZT5hcmNoaXZlX21vZGU8L3Zhcm5hbWU+IG11c3QgYmUgPGxpdGVyYWw+YWx3YXlzPC9saXRl
cmFsPiBpbiBvcmRlcgogICAgICBmb3IgPGZ1bmN0aW9uPnBnX2JhY2t1cF9zdG9wPC9mdW5j
dGlvbj4gdG8gd2FpdC4KICAgICAgQXJjaGl2aW5nIG9mIHRoZXNlIGZpbGVzIGhhcHBlbnMg
YXV0b21hdGljYWxseSBzaW5jZSB5b3UgaGF2ZQotICAgICBhbHJlYWR5IGNvbmZpZ3VyZWQg
PHZhcm5hbWU+YXJjaGl2ZV9saWJyYXJ5PC92YXJuYW1lPi4gSW4gbW9zdCBjYXNlcyB0aGlz
Ci0gICAgIGhhcHBlbnMgcXVpY2tseSwgYnV0IHlvdSBhcmUgYWR2aXNlZCB0byBtb25pdG9y
IHlvdXIgYXJjaGl2ZQorICAgICBhbHJlYWR5IGNvbmZpZ3VyZWQgPHZhcm5hbWU+YXJjaGl2
ZV9saWJyYXJ5PC92YXJuYW1lPiBvciA8dmFybmFtZT5hcmNoaXZlX2NvbW1hbmQ8L3Zhcm5h
bWU+LgorICAgICBJbiBtb3N0IGNhc2VzIHRoaXMgaGFwcGVucyBxdWlja2x5LCBidXQgeW91
IGFyZSBhZHZpc2VkIHRvIG1vbml0b3IgeW91ciBhcmNoaXZlCiAgICAgIHN5c3RlbSB0byBl
bnN1cmUgdGhlcmUgYXJlIG5vIGRlbGF5cy4KLSAgICAgSWYgdGhlIGFyY2hpdmUgcHJvY2Vz
cyBoYXMgZmFsbGVuIGJlaGluZAotICAgICBiZWNhdXNlIG9mIGZhaWx1cmVzIG9mIHRoZSBh
cmNoaXZlIGxpYnJhcnksIGl0IHdpbGwga2VlcCByZXRyeWluZworICAgICBJZiB0aGUgYXJj
aGl2ZSBwcm9jZXNzIGhhcyBmYWxsZW4gYmVoaW5kIGJlY2F1c2Ugb2YgZmFpbHVyZXMgb2Yg
dGhlIGFyY2hpdmUgbGlicmFyeSBvcgorICAgICBhcmNoaXZlIGNvbW1hbmQsIGl0IHdpbGwg
a2VlcCByZXRyeWluZwogICAgICB1bnRpbCB0aGUgYXJjaGl2ZSBzdWNjZWVkcyBhbmQgdGhl
IGJhY2t1cCBpcyBjb21wbGV0ZS4KICAgICAgSWYgeW91IHdpc2ggdG8gcGxhY2UgYSB0aW1l
IGxpbWl0IG9uIHRoZSBleGVjdXRpb24gb2YKICAgICAgPGZ1bmN0aW9uPnBnX2JhY2t1cF9z
dG9wPC9mdW5jdGlvbj4sIHNldCBhbiBhcHByb3ByaWF0ZQpkaWZmIC0tZ2l0IGEvZG9jL3Ny
Yy9zZ21sL3JlZi9wZ19iYXNlYmFja3VwLnNnbWwgYi9kb2Mvc3JjL3NnbWwvcmVmL3BnX2Jh
c2ViYWNrdXAuc2dtbAppbmRleCA1NmFjN2I3NTRiZS4uYTVmNjNiZDY2MDkgMTAwNjQ0Ci0t
LSBhL2RvYy9zcmMvc2dtbC9yZWYvcGdfYmFzZWJhY2t1cC5zZ21sCisrKyBiL2RvYy9zcmMv
c2dtbC9yZWYvcGdfYmFzZWJhY2t1cC5zZ21sCkBAIC0xMDEsOSArMTAxLDcgQEAgUG9zdGdy
ZVNRTCBkb2N1bWVudGF0aW9uCiAgICAgPGxpc3RpdGVtPgogICAgICA8cGFyYT4KICAgICAg
IEFsbCBXQUwgcmVjb3JkcyByZXF1aXJlZCBmb3IgdGhlIGJhY2t1cCBtdXN0IGNvbnRhaW4g
c3VmZmljaWVudCBmdWxsLXBhZ2Ugd3JpdGVzLAotICAgICAgd2hpY2ggcmVxdWlyZXMgeW91
IHRvIGVuYWJsZSA8dmFybmFtZT5mdWxsX3BhZ2Vfd3JpdGVzPC92YXJuYW1lPiBvbiB0aGUg
cHJpbWFyeSBhbmQKLSAgICAgIG5vdCB0byB1c2UgYSB0b29sIGluIHlvdXIgPHZhcm5hbWU+
YXJjaGl2ZV9saWJyYXJ5PC92YXJuYW1lPiB0byByZW1vdmUKLSAgICAgIGZ1bGwtcGFnZSB3
cml0ZXMgZnJvbSBXQUwgZmlsZXMuCisgICAgICB3aGljaCByZXF1aXJlcyB5b3UgdG8gZW5h
YmxlIDx2YXJuYW1lPmZ1bGxfcGFnZV93cml0ZXM8L3Zhcm5hbWU+IG9uIHRoZSBwcmltYXJ5
LgogICAgICA8L3BhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgIDwvaXRlbWl6ZWRsaXN0Pgo=

--------------USarlNgcw4YxQHeS9TmbW1tH
Content-Type: text/x-patch; charset=UTF-8; name="PGSQL15_tags_fix2.patch"
Content-Disposition: attachment; filename="PGSQL15_tags_fix2.patch"
Content-Transfer-Encoding: base64

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9hZG1pbnBhY2suc2dtbCBiL2RvYy9zcmMvc2dt
bC9hZG1pbnBhY2suc2dtbAppbmRleCA0MGNhYjI5YjI0Ny4uMjhhY2U1NzRkZDUgMTAwNjQ0
Ci0tLSBhL2RvYy9zcmMvc2dtbC9hZG1pbnBhY2suc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwv
YWRtaW5wYWNrLnNnbWwKQEAgLTIyLDggKzIyLDkgQEAKICAgZnVuY3Rpb25zIGluIDx4cmVm
IGxpbmtlbmQ9ImZ1bmN0aW9ucy1hZG1pbi1nZW5maWxlLXRhYmxlIi8+LCB3aGljaAogICBw
cm92aWRlIHJlYWQtb25seSBhY2Nlc3MuKQogICBPbmx5IGZpbGVzIHdpdGhpbiB0aGUgZGF0
YWJhc2UgY2x1c3RlciBkaXJlY3RvcnkgY2FuIGJlIGFjY2Vzc2VkLCB1bmxlc3MgdGhlCi0g
IHVzZXIgaXMgYSBzdXBlcnVzZXIgb3IgZ2l2ZW4gcHJpdmlsZWdlcyBvZiBvbmUgb2YgdGhl
IHBnX3JlYWRfc2VydmVyX2ZpbGVzLAotICBvciBwZ193cml0ZV9zZXJ2ZXJfZmlsZXMgcm9s
ZXMsIGFzIGFwcHJvcHJpYXRlIGZvciB0aGUgZnVuY3Rpb24sIGJ1dCBlaXRoZXIgYQorICB1
c2VyIGlzIGEgc3VwZXJ1c2VyIG9yIGdpdmVuIHByaXZpbGVnZXMgb2Ygb25lIG9mIHRoZQor
ICA8bGl0ZXJhbD5wZ19yZWFkX3NlcnZlcl9maWxlczwvbGl0ZXJhbD4gb3IgPGxpdGVyYWw+
cGdfd3JpdGVfc2VydmVyX2ZpbGVzPC9saXRlcmFsPgorICByb2xlcywgYXMgYXBwcm9wcmlh
dGUgZm9yIHRoZSBmdW5jdGlvbiwgYnV0IGVpdGhlciBhCiAgIHJlbGF0aXZlIG9yIGFic29s
dXRlIHBhdGggaXMgYWxsb3dhYmxlLgogIDwvcGFyYT4KIApkaWZmIC0tZ2l0IGEvZG9jL3Ny
Yy9zZ21sL2FyY2hpdmUtbW9kdWxlcy5zZ21sIGIvZG9jL3NyYy9zZ21sL2FyY2hpdmUtbW9k
dWxlcy5zZ21sCmluZGV4IGVlNzBlOTIyNDkwLi4zN2IxZmMwNjFlZCAxMDA2NDQKLS0tIGEv
ZG9jL3NyYy9zZ21sL2FyY2hpdmUtbW9kdWxlcy5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9h
cmNoaXZlLW1vZHVsZXMuc2dtbApAQCAtMTEyLDggKzExMiw4IEBAIHR5cGVkZWYgYm9vbCAo
KkFyY2hpdmVGaWxlQ0IpIChjb25zdCBjaGFyICpmaWxlLCBjb25zdCBjaGFyICpwYXRoKTsK
ICAgICB3YXMgc3VjY2Vzc2Z1bGx5IGFyY2hpdmVkLCB3aGljaCBtYXkgaW5jbHVkZSByZWN5
Y2xpbmcgb3IgcmVtb3ZpbmcgdGhlCiAgICAgb3JpZ2luYWwgV0FMIGZpbGUuICBJZiA8bGl0
ZXJhbD5mYWxzZTwvbGl0ZXJhbD4gaXMgcmV0dXJuZWQsIHRoZSBzZXJ2ZXIgd2lsbAogICAg
IGtlZXAgdGhlIG9yaWdpbmFsIFdBTCBmaWxlIGFuZCByZXRyeSBhcmNoaXZpbmcgbGF0ZXIu
Ci0gICAgPGxpdGVyYWw+ZmlsZTwvbGl0ZXJhbD4gd2lsbCBjb250YWluIGp1c3QgdGhlIGZp
bGUgbmFtZSBvZiB0aGUgV0FMIGZpbGUgdG8KLSAgICBhcmNoaXZlLCB3aGlsZSA8bGl0ZXJh
bD5wYXRoPC9saXRlcmFsPiBjb250YWlucyB0aGUgZnVsbCBwYXRoIG9mIHRoZSBXQUwKKyAg
ICA8cmVwbGFjZWFibGU+ZmlsZTwvcmVwbGFjZWFibGU+IHdpbGwgY29udGFpbiBqdXN0IHRo
ZSBmaWxlIG5hbWUgb2YgdGhlIFdBTCBmaWxlIHRvCisgICAgYXJjaGl2ZSwgd2hpbGUgPHJl
cGxhY2VhYmxlPnBhdGg8L3JlcGxhY2VhYmxlPiBjb250YWlucyB0aGUgZnVsbCBwYXRoIG9m
IHRoZSBXQUwKICAgICBmaWxlIChpbmNsdWRpbmcgdGhlIGZpbGUgbmFtZSkuCiAgICA8L3Bh
cmE+CiAgIDwvc2VjdDI+CmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwg
Yi9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwKaW5kZXggNzNhNzc0ZDNkN2YuLjRlYWI2NDEx
YTRlIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwKKysrIGIvZG9jL3Ny
Yy9zZ21sL2JhY2t1cC5zZ21sCkBAIC02NjgsOSArNjY4LDEwIEBAIHRlc3QgISAtZiAvbW50
L3NlcnZlci9hcmNoaXZlZGlyLzAwMDAwMDAxMDAwMDAwQTkwMDAwMDA2NSAmYW1wOyZhbXA7
IGNwIHBnX3dhbC8wCiAgICA8cGFyYT4KICAgICBJZiB0aGUgYXJjaGl2ZSBmdW5jdGlvbiBl
bWl0cyBhbiA8bGl0ZXJhbD5FUlJPUjwvbGl0ZXJhbD4gb3IKICAgICA8bGl0ZXJhbD5GQVRB
TDwvbGl0ZXJhbD4sIHRoZSBhcmNoaXZlciBwcm9jZXNzIGFib3J0cyBhbmQgZ2V0cyByZXN0
YXJ0ZWQgYnkKLSAgICB0aGUgcG9zdG1hc3Rlci4gIElmIHlvdSBhcmUgYXJjaGl2aW5nIHZp
YSBzaGVsbCBjb21tYW5kLCBGQVRBTCBpcyBlbWl0dGVkIGlmCi0gICAgdGhlIGNvbW1hbmQg
aXMgdGVybWluYXRlZCBieSBhIHNpZ25hbCAob3RoZXIgdGhhbgotICAgIDxzeXN0ZW1pdGVt
PlNJR1RFUk08L3N5c3RlbWl0ZW0+IHRoYXQgaXMgdXNlZCBhcyBwYXJ0IG9mIGEgc2VydmVy
IHNodXRkb3duKQorICAgIHRoZSBwb3N0bWFzdGVyLiAgSWYgeW91IGFyZSBhcmNoaXZpbmcg
dmlhIHNoZWxsIGNvbW1hbmQsCisgICAgPGxpdGVyYWw+RkFUQUw8L2xpdGVyYWw+IGlzIGVt
aXR0ZWQgaWYgdGhlIGNvbW1hbmQgaXMgdGVybWluYXRlZCBieSBhIHNpZ25hbAorICAgIChv
dGhlciB0aGFuIDxzeXN0ZW1pdGVtPlNJR1RFUk08L3N5c3RlbWl0ZW0+CisgICAgdGhhdCBp
cyB1c2VkIGFzIHBhcnQgb2YgYSBzZXJ2ZXIgc2h1dGRvd24pCiAgICAgb3IgYW4gZXJyb3Ig
YnkgdGhlIHNoZWxsIHdpdGggYW4gZXhpdCBzdGF0dXMgZ3JlYXRlciB0aGFuIDEyNSAoc3Vj
aCBhcwogICAgIGNvbW1hbmQgbm90IGZvdW5kKS4gIEluIHN1Y2ggY2FzZXMsIHRoZSBmYWls
dXJlIGlzIG5vdCByZXBvcnRlZCBpbgogICAgIDx4cmVmIGxpbmtlbmQ9InBnLXN0YXQtYXJj
aGl2ZXItdmlldyIvPi4KQEAgLTg3Miw4ICs4NzMsOCBAQCB0ZXN0ICEgLWYgL21udC9zZXJ2
ZXIvYXJjaGl2ZWRpci8wMDAwMDAwMTAwMDAwMEE5MDAwMDAwNjUgJmFtcDsmYW1wOyBjcCBw
Z193YWwvMAogICAgPGxpc3RpdGVtPgogICAgIDxwYXJhPgogICAgICBDb25uZWN0IHRvIHRo
ZSBzZXJ2ZXIgKGl0IGRvZXMgbm90IG1hdHRlciB3aGljaCBkYXRhYmFzZSkgYXMgYSB1c2Vy
IHdpdGgKLSAgICAgcmlnaHRzIHRvIHJ1biBwZ19iYWNrdXBfc3RhcnQgKHN1cGVydXNlciwg
b3IgYSB1c2VyIHdobyBoYXMgYmVlbiBncmFudGVkCi0gICAgIEVYRUNVVEUgb24gdGhlIGZ1
bmN0aW9uKSBhbmQgaXNzdWUgdGhlIGNvbW1hbmQ6CisgICAgIHJpZ2h0cyB0byBydW4gPGZ1
bmN0aW9uPnBnX2JhY2t1cF9zdGFydDwvZnVuY3Rpb24+IChzdXBlcnVzZXIsCisgICAgIG9y
IGEgdXNlciB3aG8gaGFzIGJlZW4gZ3JhbnRlZCBFWEVDVVRFIG9uIHRoZSBmdW5jdGlvbikg
YW5kIGlzc3VlIHRoZSBjb21tYW5kOgogPHByb2dyYW1saXN0aW5nPgogU0VMRUNUIHBnX2Jh
Y2t1cF9zdGFydChsYWJlbCA9PiAnbGFiZWwnLCBmYXN0ID0+IGZhbHNlKTsKIDwvcHJvZ3Jh
bWxpc3Rpbmc+CmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvYmFzZWJhY2t1cC10by1zaGVs
bC5zZ21sIGIvZG9jL3NyYy9zZ21sL2Jhc2ViYWNrdXAtdG8tc2hlbGwuc2dtbAppbmRleCA4
NTg2OGRiM2MxNS4uM2Q1NDk2ZjY5MmYgMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9iYXNl
YmFja3VwLXRvLXNoZWxsLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL2Jhc2ViYWNrdXAtdG8t
c2hlbGwuc2dtbApAQCAtMTIsOSArMTIsOSBAQAogICBjYWxsZWQgPGxpdGVyYWw+c2hlbGw8
L2xpdGVyYWw+LiBUaGlzIG1ha2VzIGl0IHBvc3NpYmxlIHRvIHJ1bgogICA8bGl0ZXJhbD5w
Z19iYXNlYmFja3VwIC0tdGFyZ2V0PXNoZWxsPC9saXRlcmFsPiBvciwgZGVwZW5kaW5nIG9u
IGhvdyB0aGlzCiAgIG1vZHVsZSBpcyBjb25maWd1cmVkLAotICA8bGl0ZXJhbD5wZ19iYXNl
YmFja3VwIC0tdGFyZ2V0PXNoZWxsOkRFVEFJTF9TVFJJTkc8L2xpdGVyYWw+LCBhbmQgY2F1
c2UKLSAgYSBzZXJ2ZXIgY29tbWFuZCBjaG9zZW4gYnkgdGhlIHNlcnZlciBhZG1pbmlzdHJh
dG9yIHRvIGJlIGV4ZWN1dGVkIGZvcgotICBlYWNoIHRhciBhcmNoaXZlIGdlbmVyYXRlZCBi
eSB0aGUgYmFja3VwIHByb2Nlc3MuIFRoZSBjb21tYW5kIHdpbGwgcmVjZWl2ZQorICA8bGl0
ZXJhbD5wZ19iYXNlYmFja3VwIC0tdGFyZ2V0PXNoZWxsOjxyZXBsYWNlYWJsZT5ERVRBSUxf
U1RSSU5HPC9yZXBsYWNlYWJsZT48L2xpdGVyYWw+LAorICBhbmQgY2F1c2UgYSBzZXJ2ZXIg
Y29tbWFuZCBjaG9zZW4gYnkgdGhlIHNlcnZlciBhZG1pbmlzdHJhdG9yIHRvIGJlIGV4ZWN1
dGVkCisgIGZvciBlYWNoIHRhciBhcmNoaXZlIGdlbmVyYXRlZCBieSB0aGUgYmFja3VwIHBy
b2Nlc3MuIFRoZSBjb21tYW5kIHdpbGwgcmVjZWl2ZQogICB0aGUgY29udGVudHMgb2YgdGhl
IGFyY2hpdmUgdmlhIHN0YW5kYXJkIGlucHV0LgogIDwvcGFyYT4KIApkaWZmIC0tZ2l0IGEv
ZG9jL3NyYy9zZ21sL3JlZi9hbHRlcl9wdWJsaWNhdGlvbi5zZ21sIGIvZG9jL3NyYy9zZ21s
L3JlZi9hbHRlcl9wdWJsaWNhdGlvbi5zZ21sCmluZGV4IDNlMzM4ZjRjYzVkLi4zYTc0OTcz
ZGEwMSAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL3JlZi9hbHRlcl9wdWJsaWNhdGlvbi5z
Z21sCisrKyBiL2RvYy9zcmMvc2dtbC9yZWYvYWx0ZXJfcHVibGljYXRpb24uc2dtbApAQCAt
MTIxLDcgKzEyMSw3IEBAIEFMVEVSIFBVQkxJQ0FUSU9OIDxyZXBsYWNlYWJsZSBjbGFzcz0i
cGFyYW1ldGVyIj5uYW1lPC9yZXBsYWNlYWJsZT4gUkVOQU1FIFRPIDxyCiAgICAgICB3aXRo
IGRpZmZlcmVudCBjb2x1bW4gbGlzdHMgaXMgbm90IHN1cHBvcnRlZC4gU28sIGNoYW5naW5n
IHRoZSBjb2x1bW4KICAgICAgIGxpc3RzIG9mIHRoZSB0YWJsZXMgYmVpbmcgc3Vic2NyaWJl
ZCBjb3VsZCBjYXVzZSBpbmNvbnNpc3RlbmN5IG9mIGNvbHVtbgogICAgICAgbGlzdHMgYW1v
bmcgcHVibGljYXRpb25zLCBpbiB3aGljaCBjYXNlIDxjb21tYW5kPkFMVEVSIFBVQkxJQ0FU
SU9OPC9jb21tYW5kPgotICAgICAgd2lsbCBiZSBzdWNjZXNzZnVsIGJ1dCBsYXRlciB0aGUg
V2FsU2VuZGVyIG9uIHRoZSBwdWJsaXNoZXIgb3IgdGhlCisgICAgICB3aWxsIGJlIHN1Y2Nl
c3NmdWwgYnV0IGxhdGVyIHRoZSB3YWxzZW5kZXIgb24gdGhlIHB1Ymxpc2hlciBvciB0aGUK
ICAgICAgIHN1YnNjcmliZXIgbWF5IHRocm93IGFuIGVycm9yLiBJbiB0aGlzIHNjZW5hcmlv
LCB0aGUgdXNlciBuZWVkcyB0bwogICAgICAgcmVjcmVhdGUgdGhlIHN1YnNjcmlwdGlvbiBh
ZnRlciBhZGp1c3RpbmcgdGhlIGNvbHVtbiBsaXN0IG9yIGRyb3AgdGhlCiAgICAgICBwcm9i
bGVtYXRpYyBwdWJsaWNhdGlvbiB1c2luZwpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL3Jl
Zi9wc3FsLXJlZi5zZ21sIGIvZG9jL3NyYy9zZ21sL3JlZi9wc3FsLXJlZi5zZ21sCmluZGV4
IDY1YmIwYTZhM2YzLi4wMmZkYjEyZGM3NyAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL3Jl
Zi9wc3FsLXJlZi5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9yZWYvcHNxbC1yZWYuc2dtbApA
QCAtNDYyNSwxMCArNDYyNSwxMCBAQCB0ZXN0ZGI9Jmd0OyBcc2V0IFBST01QVDEgJyVbJTAz
M1sxOzMzOzQwbSVdJW5AJS8lUiVbJTAzM1swbSVdJSMgJwogICAgIGFuZCBTUUwgb2JqZWN0
IG5hbWVzIGluIG1hbnkgKGJ5IG5vIG1lYW5zIGFsbCkgY29udGV4dHMuICBGb3IgZXhhbXBs
ZSwKICAgICBhdCB0aGUgc3RhcnQgb2YgYSBjb21tYW5kLCB0eXBpbmcgPGxpdGVyYWw+aW5z
PC9saXRlcmFsPiBhbmQgcHJlc3NpbmcKICAgICBUQUIgd2lsbCBmaWxsIGluIDxsaXRlcmFs
Pmluc2VydCBpbnRvIDwvbGl0ZXJhbD4uICBUaGVuLCB0eXBpbmcgYSBmZXcKLSAgICBjaGFy
YWN0ZXJzIG9mIGEgdGFibGUgb3Igc2NoZW1hIG5hbWUgYW5kIHByZXNzaW5nIFRBQiB3aWxs
IGZpbGwgaW4gdGhlCi0gICAgdW5maW5pc2hlZCBuYW1lLCBvciBvZmZlciBhIG1lbnUgb2Yg
cG9zc2libGUgY29tcGxldGlvbnMgd2hlbiB0aGVyZSdzCi0gICAgbW9yZSB0aGFuIG9uZS4g
IChEZXBlbmRpbmcgb24gdGhlIGxpYnJhcnkgaW4gdXNlLCB5b3UgbWF5IG5lZWQgdG8KLSAg
ICBwcmVzcyBUQUIgbW9yZSB0aGFuIG9uY2UgdG8gZ2V0IGEgbWVudS4pCisgICAgY2hhcmFj
dGVycyBvZiBhIHRhYmxlIG9yIHNjaGVtYSBuYW1lIGFuZCBwcmVzc2luZyA8bGl0ZXJhbD5U
QUI8L2xpdGVyYWw+CisgICAgd2lsbCBmaWxsIGluIHRoZSB1bmZpbmlzaGVkIG5hbWUsIG9y
IG9mZmVyIGEgbWVudSBvZiBwb3NzaWJsZSBjb21wbGV0aW9ucworICAgIHdoZW4gdGhlcmUn
cyBtb3JlIHRoYW4gb25lLiAgKERlcGVuZGluZyBvbiB0aGUgbGlicmFyeSBpbiB1c2UsIHlv
dSBtYXkgbmVlZCB0bworICAgIHByZXNzIDxsaXRlcmFsPlRBQjwvbGl0ZXJhbD4gbW9yZSB0
aGFuIG9uY2UgdG8gZ2V0IGEgbWVudS4pCiAgICAgPC9wYXJhPgogCiAgICAgPHBhcmE+CkBA
IC00NjU3LDcgKzQ2NTcsNyBAQCAkZW5kaWYKICAgICAgb2YgPGFwcGxpY2F0aW9uPnBzcWw8
L2FwcGxpY2F0aW9uPi4gIFRoaXMgcHJldmVudHMgdGFiIGNvbXBsZXRpb24sCiAgICAgIHVz
ZSBvciByZWNvcmRpbmcgb2YgY29tbWFuZCBsaW5lIGhpc3RvcnksIGFuZCBlZGl0aW5nIG9m
IG11bHRpLWxpbmUKICAgICAgY29tbWFuZHMuICBJdCBpcyBwYXJ0aWN1bGFybHkgdXNlZnVs
IHdoZW4geW91IG5lZWQgdG8gY29weS1hbmQtcGFzdGUKLSAgICAgdGV4dCB0aGF0IGNvbnRh
aW5zIFRBQiBjaGFyYWN0ZXJzLgorICAgICB0ZXh0IHRoYXQgY29udGFpbnMgPGxpdGVyYWw+
VEFCPC9saXRlcmFsPiBjaGFyYWN0ZXJzLgogICAgIDwvcGFyYT4KICAgIDwvcmVmc2VjdDM+
CiAgIDwvcmVmc2VjdDI+Cg==

--------------USarlNgcw4YxQHeS9TmbW1tH--