pg.ddx.io pgsql-docs@postgresql.org mailing list archivehelp / color / mirror / Atom feed
The examples given in Chapter 14 are not true. 2+ messages / 2 participants [nested] [flat]
* The examples given in Chapter 14 are not true. @ 2024-05-26 13:58 PG Doc comments form <noreply@postgresql.org> 0 siblings, 1 reply; 2+ messages in thread From: PG Doc comments form @ 2024-05-26 13:58 UTC (permalink / raw) To: pgsql-docs@lists.postgresql.org; +Cc: y.saburov@gmail.com 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/... 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? ^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: The examples given in Chapter 14 are not true. @ 2024-05-26 14:35 Tom Lane <tgl@sss.pgh.pa.us> parent: PG Doc comments form <noreply@postgresql.org> 0 siblings, 0 replies; 2+ messages in thread From: Tom Lane @ 2024-05-26 14:35 UTC (permalink / raw) To: y.saburov@gmail.com; +Cc: pgsql-docs@lists.postgresql.org PG Doc comments form <noreply@postgresql.org> writes: > Page: https://www.postgresql.org/docs/16/performance-tips.html > 1) How did you create the `tenk1` table? As the text says, it's supposed to be made by running the core regression tests ("make installcheck"). > 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`. Yeah, that's a bit out of date. I fixed it up awhile ago for v17: https://git.postgresql.org/gitweb/?p=postgresql.git&a=commitdiff&h=5caa05749 However, the text also points out that you won't necessarily get exactly the same results as are shown, for assorted reasons of which different-version is only one. So I think these changes were more neatnik-ism than rescuing the chapter from total irrelevancy. regards, tom lane ^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2024-05-26 14:35 UTC | newest] Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2024-05-26 13:58 The examples given in Chapter 14 are not true. PG Doc comments form <noreply@postgresql.org> 2024-05-26 14:35 ` Tom Lane <tgl@sss.pgh.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions for how to clone and mirror all data and code used for this inbox