database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-07 00:36:50 +03:00
Code Activity

Doc: fix bogus cross-reference link.

Browse Source 
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.
This commit is contained in:
Tom Lane
2018-05-21 11:21:08 -04:00
parent 3ce7f72529
commit 3f5e3a9844
2 changed files with 10 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
doc/src/sgml/jit.sgml
View File

@ -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>

10
doc/src/sgml/storage.sgml
View File

@ -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>
<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>
</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>
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>