RE: PGdoc: add missing ID attribute to create_subscription.sgml

From: "Hayato Kuroda (Fujitsu)" <kuroda(dot)hayato(at)fujitsu(dot)com>
To: 'Peter Smith' <smithpb2250(at)gmail(dot)com>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>, Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>, "shiy(dot)fnst(at)fujitsu(dot)com" <shiy(dot)fnst(at)fujitsu(dot)com>, Melih Mutlu <m(dot)melihmutlu(at)gmail(dot)com>, vignesh C <vignesh21(at)gmail(dot)com>, Euler Taveira <euler(at)eulerto(dot)com>, Bharath Rupireddy <bharath(dot)rupireddyforpostgres(at)gmail(dot)com>, "Takamichi Osumi (Fujitsu)" <osumi(dot)takamichi(at)fujitsu(dot)com>
Subject: RE: PGdoc: add missing ID attribute to create_subscription.sgml
Date: 2023-03-28 03:04:47
Message-ID: TYAPR01MB586613F0CE8C060FD2381B07F5889@TYAPR01MB5866.jpnprd01.prod.outlook.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Dear Peter,

Thank you for reviewing. PSA new version.

> ////////
> v3-0001
> ////////
>
> This patch looks good, but I think there are a couple of other places
> where you could add links:
>
> ~~~
>
> 1.1 doc/src/sgml/logical-replication.sgml (31.5 Conflicts)
>
> "When the streaming mode is parallel, the finish LSN ..."
>
> Maybe you can add a "streaming" link there.

Added. It could not be detected because this is not tagged as <literal>.

> 1.2. doc/src/sgml/logical-replication.sgml (31.5 31.8. Monitoring)
>
> "Moreover, if the streaming transaction is applied in parallel, there
> may be additional parallel apply workers."
>
> Maybe you can add a "streaming" link there.

Added.

> ////////
> v3-0002
> ////////
>
> There is one bug, and I think there are a couple of other places where
> you could add links:
>
> ~~~
>
> 2.1 doc/src/sgml/logical-replication.sgml (31.4. Column Lists blurb)
>
> For partitioned tables, the publication parameter
> publish_via_partition_root determines which column list is used.
>
> ~
>
> Maybe you can add a "publish_via_partition_root" link there.

Added. I'm not sure why I missed it...

> 2.2 doc/src/sgml/logical-replication.sgml (31.6. Restrictions)
>
> Publications can also specify that changes are to be replicated using
> the identity and schema of the partitioned root table instead of that
> of the individual leaf partitions in which the changes actually
> originate (see CREATE PUBLICATION).
>
> ~
>
> Maybe that text can be changed now to say something like "(see
> publish_via_partition_root parameter of CREATE PUBLICATION)” -- so
> only the parameter part has the link, not the CREATE PUBLICATION part.

Seems better, added.

> 2.3 doc/src/sgml/logical-replication.sgml (31.9. Security)
>
> + subscription <link
> linkend="sql-createpublication-for-all-tables"><literal>FOR ALL
> TABLES</literal></link>
> + or <link
> linkend="sql-createpublication-for-tables-in-schema"><literal>FOR
> TABLES IN SCHEMA</literal></link><literal>FOR TABLES IN
> SCHEMA</literal>
> + only when superusers trust every user permitted to create a non-temp table
> + on the publisher or the subscriber.
>
> There is a cut/paste typo here -- it renders badly with "FOR TABLES IN
> SCHEMA" appearing 2x.
>

That's my fault, fixed.

Best Regards,
Hayato Kuroda
FUJITSU LIMITED

Attachment Content-Type Size
v4-0001-Add-XML-ID-attributes-to-create_subscription.sgml.patch application/octet-stream 17.4 KB
v4-0002-Add-XML-ID-attributes-to-create_publication.sgml.patch application/octet-stream 16.1 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Geoghegan 2023-03-28 03:12:11 Re: Why mark empty pages all visible?
Previous Message Stephen Frost 2023-03-28 02:56:58 Re: Moving forward with TDE