From 7d835ff4db19c515171d6c8de772536c55600753 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Mon, 11 Aug 2014 22:52:16 +0900 Subject: [PATCH] Fix documentation oversights about pageinspect and initialization fork. The initialization fork was added in 9.1, but has not been taken into consideration in documents of get_raw_page function in pageinspect and storage layout. This commit fixes those oversights. get_raw_page can read not only a table but also an index, etc. So it should be documented that the function can read any relation. This commit also fixes the document of pageinspect that way. Back-patch to 9.1 where those oversights existed. Vik Fearing, review by MauMau --- doc/src/sgml/pageinspect.sgml | 7 ++++--- doc/src/sgml/storage.sgml | 4 ++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/src/sgml/pageinspect.sgml b/doc/src/sgml/pageinspect.sgml index 9232183896..191fb156c1 100644 --- a/doc/src/sgml/pageinspect.sgml +++ b/doc/src/sgml/pageinspect.sgml @@ -28,11 +28,12 @@ get_raw_page reads the specified block of the named - table and returns a copy as a bytea value. This allows a + relation and returns a copy as a bytea value. This allows a single time-consistent copy of the block to be obtained. fork should be 'main' for - the main data fork, or 'fsm' for the free space map, - or 'vm' for the visibility map. + the main data fork, 'fsm' for the free space map, + 'vm' for the visibility map, or 'init' + for the initialization fork. diff --git a/doc/src/sgml/storage.sgml b/doc/src/sgml/storage.sgml index 4c7fb6c6fa..920b5f0dc3 100644 --- a/doc/src/sgml/storage.sgml +++ b/doc/src/sgml/storage.sgml @@ -265,8 +265,8 @@ The pg_relation_filepath() function shows the entire path as a substitute for remembering many of the above rules. But keep in mind that this function just gives the name of the first segment of the main fork of the relation — you may need to append a segment number -and/or _fsm or _vm to find all the files associated -with the relation. +and/or _fsm, _vm, or _init to find all +the files associated with the relation.