Re: Documentation improvement patch
Peter Eisentraut <peter@eisentraut.org>
From: Peter Eisentraut <peter@eisentraut.org>
To: Oleg <o.sibiryakov@postgrespro.ru>, Daniel Gustafsson <daniel@yesql.se>
Cc: pgsql-docs@lists.postgresql.org
Date: 2025-10-30T10:15:26Z
Lists: pgsql-docs
On 25.10.25 21:01, Oleg wrote:
> Dear Daniel,
>
> Thank you for your prompt feedback.
>
> Attached, please find the updated documentation patch, which
> incorporates your suggestions from both the first and second rounds of
> review.
<term><literal>ALTER_REPLICATION_SLOT</literal> <replaceable
class="parameter">slot_name</replaceable> ( <replaceable
class="parameter">option</replaceable> [, ...] )
<indexterm><primary>ALTER_REPLICATION_SLOT</primary></indexterm>
</term>
<listitem>
<para>
- Change the definition of a replication slot.
+ Changes the definition of a replication slot.
I think these are intentionally written in imperative style. Compare
the synopses of the main SQL commands: "change the definition of a
domain" etc.
- First, define a <literal>PgStat_KindInfo</literal> that includes all
+ First, define <literal>PgStat_KindInfo</literal> that includes all
I think this change is incorrect. You are being asked to define an
instance of PgStat_KindInfo, not PgStat_KindInfo itself (which already
exists).
The remaining changes look ok to me.
Commits
-
doc: Assorted documentation improvements
- fa0ffa28778f 19 (unreleased) landed