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 @@
</para>
<para>
Tuple deforming is the process of transforming an on-disk tuple (see <xref
linkend="heaptuple"/>) into its in-memory representation. It can be
accelerated by creating a function specific to the table layout and the
number of columns to be extracted.
linkend="storage-tuple-layout"/>) into its in-memory representation.
It can be accelerated by creating a function specific to the table layout
and the number of columns to be extracted.
</para>
</sect2>
......
......@@ -875,8 +875,7 @@ data. Empty in ordinary tables.</entry>
<filename>src/include/storage/bufpage.h</filename>.
</para>
<para id="heaptuple">
<para>
Following the page header are item identifiers
(<type>ItemIdData</type>), each requiring four bytes.
An item identifier contains a byte-offset to
......@@ -909,7 +908,7 @@ data. Empty in ordinary tables.</entry>
<para>
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,
as well as some other data relevant to the index structure.
Ordinary tables do not use a special section at all (indicated by setting
......@@ -917,6 +916,10 @@ data. Empty in ordinary tables.</entry>
</para>
<sect2 id="storage-tuple-layout">
<title>Table Row Layout</title>
<para>
All table rows are structured in the same way. There is a fixed-size
......@@ -1040,6 +1043,7 @@ data. Empty in ordinary tables.</entry>
it might be compressed, too (see <xref linkend="storage-toast"/>).
</para>
</sect2>
</sect1>
</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