Commit 3f5e3a98 authored by Tom Lane's avatar Tom Lane

Doc: fix bogus cross-reference link.

An xref to a <para>'s ID isn't very helpful because paras don't have
names.  This causes a warning while building PDFs, though for some
reason not while building HTML.  The link arguably went to the wrong
place, too.

To fix, introduce a sub-section we can reference.
parent 3ce7f725
...@@ -58,9 +58,9 @@ ...@@ -58,9 +58,9 @@
</para> </para>
<para> <para>
Tuple deforming is the process of transforming an on-disk tuple (see <xref Tuple deforming is the process of transforming an on-disk tuple (see <xref
linkend="heaptuple"/>) into its in-memory representation. It can be linkend="storage-tuple-layout"/>) into its in-memory representation.
accelerated by creating a function specific to the table layout and the It can be accelerated by creating a function specific to the table layout
number of columns to be extracted. and the number of columns to be extracted.
</para> </para>
</sect2> </sect2>
......
...@@ -875,8 +875,7 @@ data. Empty in ordinary tables.</entry> ...@@ -875,8 +875,7 @@ data. Empty in ordinary tables.</entry>
<filename>src/include/storage/bufpage.h</filename>. <filename>src/include/storage/bufpage.h</filename>.
</para> </para>
<para id="heaptuple"> <para>
Following the page header are item identifiers Following the page header are item identifiers
(<type>ItemIdData</type>), each requiring four bytes. (<type>ItemIdData</type>), each requiring four bytes.
An item identifier contains a byte-offset to An item identifier contains a byte-offset to
...@@ -909,7 +908,7 @@ data. Empty in ordinary tables.</entry> ...@@ -909,7 +908,7 @@ data. Empty in ordinary tables.</entry>
<para> <para>
The final section is the <quote>special section</quote> which can The final section is the <quote>special section</quote> which can
contain anything the access method wishes to store. For example, contain anything the access method wishes to store. For example,
b-tree indexes store links to the page's left and right siblings, b-tree indexes store links to the page's left and right siblings,
as well as some other data relevant to the index structure. as well as some other data relevant to the index structure.
Ordinary tables do not use a special section at all (indicated by setting Ordinary tables do not use a special section at all (indicated by setting
...@@ -917,6 +916,10 @@ data. Empty in ordinary tables.</entry> ...@@ -917,6 +916,10 @@ data. Empty in ordinary tables.</entry>
</para> </para>
<sect2 id="storage-tuple-layout">
<title>Table Row Layout</title>
<para> <para>
All table rows are structured in the same way. There is a fixed-size All table rows are structured in the same way. There is a fixed-size
...@@ -1040,6 +1043,7 @@ data. Empty in ordinary tables.</entry> ...@@ -1040,6 +1043,7 @@ data. Empty in ordinary tables.</entry>
it might be compressed, too (see <xref linkend="storage-toast"/>). it might be compressed, too (see <xref linkend="storage-toast"/>).
</para> </para>
</sect2>
</sect1> </sect1>
</chapter> </chapter>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment