Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 3f5e3a9

Browse files
committed
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.
1 parent 3ce7f72 commit 3f5e3a9

File tree

2 files changed

+10
-6
lines changed

2 files changed

+10
-6
lines changed

doc/src/sgml/jit.sgml

+3-3
Original file line numberDiff line numberDiff line change
@@ -58,9 +58,9 @@
5858
</para>
5959
<para>
6060
Tuple deforming is the process of transforming an on-disk tuple (see <xref
61-
linkend="heaptuple"/>) into its in-memory representation. It can be
62-
accelerated by creating a function specific to the table layout and the
63-
number of columns to be extracted.
61+
linkend="storage-tuple-layout"/>) into its in-memory representation.
62+
It can be accelerated by creating a function specific to the table layout
63+
and the number of columns to be extracted.
6464
</para>
6565
</sect2>
6666

doc/src/sgml/storage.sgml

+7-3
Original file line numberDiff line numberDiff line change
@@ -875,8 +875,7 @@ data. Empty in ordinary tables.</entry>
875875
<filename>src/include/storage/bufpage.h</filename>.
876876
</para>
877877

878-
<para id="heaptuple">
879-
878+
<para>
880879
Following the page header are item identifiers
881880
(<type>ItemIdData</type>), each requiring four bytes.
882881
An item identifier contains a byte-offset to
@@ -909,14 +908,18 @@ data. Empty in ordinary tables.</entry>
909908
<para>
910909

911910
The final section is the <quote>special section</quote> which can
912-
contain anything the access method wishes to store. For example,
911+
contain anything the access method wishes to store. For example,
913912
b-tree indexes store links to the page's left and right siblings,
914913
as well as some other data relevant to the index structure.
915914
Ordinary tables do not use a special section at all (indicated by setting
916915
<structfield>pd_special</structfield> to equal the page size).
917916

918917
</para>
919918

919+
<sect2 id="storage-tuple-layout">
920+
921+
<title>Table Row Layout</title>
922+
920923
<para>
921924

922925
All table rows are structured in the same way. There is a fixed-size
@@ -1040,6 +1043,7 @@ data. Empty in ordinary tables.</entry>
10401043
it might be compressed, too (see <xref linkend="storage-toast"/>).
10411044

10421045
</para>
1046+
</sect2>
10431047
</sect1>
10441048

10451049
</chapter>

0 commit comments

Comments
 (0)