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.

diff --git a/doc/src/sgml/jit.sgml b/doc/src/sgml/jit.sgml
index fc841337c36062bf96ec31a059abd9652f37ed77..bcff1174082f0052c2d7cdc22c7c389098036401 100644 (file)
--- a/doc/src/sgml/jit.sgml
+++ b/doc/src/sgml/jit.sgml
@@ -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>
 

diff --git a/doc/src/sgml/storage.sgml b/doc/src/sgml/storage.sgml
index 70a822e05977b998aea73ea366181e8c97ce7e01..8ef2ac80106052423a2323b1d31822006b2162f2 100644 (file)
--- a/doc/src/sgml/storage.sgml
+++ b/doc/src/sgml/storage.sgml
@@ -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>