1berry/postgres
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc: Fix initdb option xreflabels

Browse Source 
Generally, we don't want any overriding xreflabels in the options
list, so that we can link to options and the link renders as the
option name.  The -g option did this differently and config.sgml made
use of that for a link.  The new --no-data-checksums option (commit
983a588e0b8) apparently copied this pattern, but that seems like the
wrong direction, as a future patch revealed.

To fix, remove the two xreflabels and rewrite the link in config.sgml
with an explicit link text.
This commit is contained in:
Peter Eisentraut 2024-10-16 08:28:12 +02:00
parent d5ca15ee54
commit 67846550dc
2 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/src/sgml/config.sgml
View File

@ -11042,7 +11042,9 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
had at server startup.
(On Microsoft Windows this parameter will always display
<literal>0700</literal>.) See
<xref linkend="app-initdb-allow-group-access"/> for more information.
<link linkend="app-initdb-allow-group-access">the
<application>initdb</application> <option>-g</option> option</link>
for more information.
</para>
</listitem>
</varlistentry>

4
doc/src/sgml/ref/initdb.sgml
View File

@ -227,7 +227,7 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry id="app-initdb-allow-group-access" xreflabel="group access">
<varlistentry id="app-initdb-allow-group-access">
<term><option>-g</option></term>
<term><option>--allow-group-access</option></term>
<listitem>
@ -260,7 +260,7 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry id="app-initdb-data-checksums" xreflabel="data checksums">
<varlistentry id="app-initdb-data-checksums">
<term><option>-k</option></term>
<term><option>--data-checksums</option></term>
<listitem>