Re: pg_wal_lsn_diff

Поиск
Список
Период
Сортировка
От Tatsuo Ishii
Тема Re: pg_wal_lsn_diff
Дата
Msg-id 20210207.105701.515450239500106923.t-ishii@sraoss.co.jp
обсуждение исходный текст
Ответ на Re: pg_wal_lsn_diff  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: pg_wal_lsn_diff  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-docs
> +1 for fixing that.  Two notes though: first, your text doesn't agree
> with the prototype ("ls1" should be "lsn1"), and second, I think it
> would read better if you didn't split the phrase "difference in bytes".
> That is,
> 
> -        Calculates the difference in bytes between two write-ahead log
> +        Calculates the difference in bytes (lsn1 - lsn2) between two write-ahead log
> 
> Also maybe you should use the <parameter>lsn1</parameter> markup
> in the text.

Thank you for the review. Attached is the revised patch.

So do you think we should back-patch to existing stable branches?  The
reason I am asking is, the doc format for v12 and before use very
simple description and if we apply the same description of this patch
to those branche, the description level for the function may look
different from other functions.

(I am not against to apply to v13).

Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index b7150510ab..1ab31a9056 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -25102,11 +25102,11 @@ SELECT collation for ('foo' COLLATE "de_DE");
         <indexterm>
          <primary>pg_wal_lsn_diff</primary>
         </indexterm>
-        <function>pg_wal_lsn_diff</function> ( <parameter>lsn</parameter> <type>pg_lsn</type>,
<parameter>lsn</parameter><type>pg_lsn</type> )
 
+        <function>pg_wal_lsn_diff</function> ( <parameter>lsn1</parameter> <type>pg_lsn</type>,
<parameter>lsn2</parameter><type>pg_lsn</type> )
 
         <returnvalue>numeric</returnvalue>
        </para>
        <para>
-        Calculates the difference in bytes between two write-ahead log
+        Calculates the difference in bytes (<parameter>lsn1</parameter> - <parameter>lsn2</parameter>) between two
write-aheadlog
 
         locations.  This can be used
         with <structname>pg_stat_replication</structname> or some of the
         functions shown in <xref linkend="functions-admin-backup-table"/> to

В списке pgsql-docs по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: The synopsis of "ALTER DEFAULT PRIVILEGES" statement is too difficult to understand
Следующее
От: Tom Lane
Дата:
Сообщение: Re: pg_wal_lsn_diff