The examples given in Chapter 14 are not true.

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: y(dot)saburov(at)gmail(dot)com
Subject: The examples given in Chapter 14 are not true.
Date: 2024-05-26 13:58:17
Message-ID: 171673189739.2021727.14284698255790538307@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/performance-tips.html
Description:

1) How did you create the `tenk1` table? If you will claim that from the
source code of version 9.3, the question arises how CREATE TABLE tenk1 (...)
WITH OIDS; in v16?

https://github.com/postgres/postgres/blob/524440579f838b30579f35d2045cc01b6f5070d8/src/test/regress/sql/create_table.sql#L37

Additionally, you have to spend time searching for additional and completely
unnecessary information and old versions of the code, although you have just
installed server version 16 from the source code, which has passed all
checks - but as it turns out is not compatible with the documentation.

After `make installcheck` v16 - All 215 tests passed. But

1) relpages for table `tenk1` - different in version 16. Some calculations
will be incorrect accordingly
2) you will not be able to reproduce examples for which there are no indexes
in table `tenk1` - for example index `index_tenk1_on_four`.
3) How do you see this familiarization with the product through
documentation that points to older versions that work very differently in
the new version?

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2024-05-26 14:35:34 Re: The examples given in Chapter 14 are not true.
Previous Message Fabrízio de Royes Mello 2024-05-24 18:59:08 Re: Add minimal C example and SQL registration example for custom table access methods.