From: Tom Lane <tgl@sss.pgh.pa.us>
To: caetano@icmc.usp.br
cc: pgsql-docs@lists.postgresql.org
Subject: Re: Mixed field in table 70.3
In-reply-to: <165107073604.680.6504816042790949419@wrigleys.postgresql.org>
References: <165107073604.680.6504816042790949419@wrigleys.postgresql.org>
Comments: In-reply-to PG Doc comments form <noreply@postgresql.org>
	message dated "Wed, 27 Apr 2022 14:45:36 -0000"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <395458.1651078230.1@sss.pgh.pa.us>
Date: Wed, 27 Apr 2022 12:50:30 -0400
Message-ID: <395459.1651078230@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/395459.1651078230%40sss.pgh.pa.us>
Precedence: bulk

PG Doc comments form <noreply@postgresql.org> writes:
> Page: https://www.postgresql.org/docs/14/storage-page-layout.html

> The 7th line states:
> pd_pagesize_version 	uint16 	2 bytes 	Page size and layout version number
> information

> In fact there are two smallints, so the table should show two attributes:
> pd_pagesize 	uint16 	2 bytes 	Page size 
> version    	uint16 	2 bytes 	Layout version number information

No, I don't think so --- this documentation matches the actual code,
in bufpage.h:

    ...
    LocationIndex pd_lower;        /* offset to start of free space */
    LocationIndex pd_upper;        /* offset to end of free space */
    LocationIndex pd_special;      /* offset to start of special space */
    uint16        pd_pagesize_version;
    TransactionId pd_prune_xid;    /* oldest prunable XID, or zero if none */
    ItemIdData    pd_linp[FLEXIBLE_ARRAY_MEMBER]; /* line pointer array */
    ...

			regards, tom lane