From 13e0d7a603852b8b05c03b45228daabffa0cced2 Mon Sep 17 00:00:00 2001
From: Michael Paquier <michael@paquier.xyz>
Date: Fri, 23 Dec 2022 09:15:01 +0900
Subject: Rename pg_dissect_walfile_name() to pg_split_walfile_name()

The former name was discussed as being confusing, so use "split", as per
a suggestion from Magnus Hagander.

While on it, one of the output arguments is renamed from "segno" to
"segment_number", as per a suggestion from Kyotaro Horiguchi.

The documentation is updated to reflect all these changes.

Bump catalog version.

Author: Bharath Rupireddy, Michael Paquier
Discussion: https://postgr.es/m/CABUevEytQVaOOhGdoh0D7hGwe3fuKcRF6NthsSW7ww04EmtFgQ@mail.gmail.com
---
 doc/src/sgml/func.sgml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

(limited to 'doc/src')

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 1f63dc6dbac..836b9254fbc 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -26101,15 +26101,15 @@ LOG:  Grand total: 1651920 bytes in 201 blocks; 622360 free (88 chunks); 1029560
       <row>
        <entry role="func_table_entry"><para role="func_signature">
         <indexterm>
-         <primary>pg_dissect_walfile_name</primary>
+         <primary>pg_split_walfile_name</primary>
         </indexterm>
-        <function>pg_dissect_walfile_name</function> ( <parameter>file_name</parameter> <type>text</type> )
+        <function>pg_split_walfile_name</function> ( <parameter>file_name</parameter> <type>text</type> )
         <returnvalue>record</returnvalue>
-        ( <parameter>segno</parameter> <type>numeric</type>,
+        ( <parameter>segment_number</parameter> <type>numeric</type>,
         <parameter>timeline_id</parameter> <type>bigint</type> )
        </para>
        <para>
-        Extracts the file sequence number and timeline ID from a WAL file
+        Extracts the sequence number and timeline ID from a WAL file
         name.
        </para></entry>
       </row>
@@ -26172,13 +26172,13 @@ postgres=# SELECT * FROM pg_walfile_name_offset((pg_backup_stop()).lsn);
    </para>
 
    <para>
-    <function>pg_dissect_walfile_name</function> is useful to compute a
+    <function>pg_split_walfile_name</function> is useful to compute a
     <acronym>LSN</acronym> from a file offset and WAL file name, for example:
 <programlisting>
 postgres=# \set file_name '000000010000000100C000AB'
 postgres=# \set offset 256
-postgres=# SELECT '0/0'::pg_lsn + pd.segno * ps.setting::int + :offset AS lsn
-  FROM pg_dissect_walfile_name(:'file_name') pd,
+postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset AS lsn
+  FROM pg_split_walfile_name(:'file_name') pd,
        pg_show_all_settings() ps
   WHERE ps.name = 'wal_segment_size';
       lsn
-- 
cgit v1.2.3