[sdk/kdesrc-build/docbook_historied_per_file] doc: doc: Add self links to the listed entries
Andrew Shark <[email protected]>
| Newsgroups | gmane.comp.kde.doc,gmane.comp.kde.cvs |
|---|---|
| Message-ID | <[email protected]> |
Git commit ccfbc22e4e3b0bfeba955a8fe9c3b8cd40792806 by Andrew Shark.
Committed on 16/01/2024 at 19:55.
Pushed by ashark into branch 'docbook_historied_per_file'.
doc: Add self links to the listed entries
Currently, the anchors are not rendered, see https://bugs.kde.org/show_bug.cgi?id=479910
To workaround, we will use links to the items itself, so users could easily copy and share the link to the option.
Original commit: 4e0a8ad0
https://invent.kde.org/sdk/kdesrc-build/-/commit/4e0a8ad0db52e3f519214c740aa21ea7f0efa5c8
M +53 -53 doc/cmdline/supported-cmdline-params.docbook
M +60 -60 doc/kdesrc-buildrc/conf-options-table.docbook
https://invent.kde.org/sdk/kdesrc-build/-/commit/ccfbc22e4e3b0bfeba955a8fe9c3b8cd40792806
diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index 219c9099..494a3363 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -6,7 +6,7 @@
<variablelist>
<varlistentry id="cmdline-pretend">
-<term><option>--pretend</option> (or <option>--dry-run</option> or <option>-p</option>)</term>
+<term><option><link linkend="cmdline-pretend">--pretend</link></option> (or <option>--dry-run</option> or <option>-p</option>)</term>
<listitem><para>
&kdesrc-build; will run through the update and build process, but instead of
performing any actions to update or build, will instead output what the
@@ -29,7 +29,7 @@ first.
</varlistentry>
<varlistentry id="cmdline-include-dependencies">
-<term><option>--include-dependencies</option> (or <option>-d</option>), <option>--no-include-dependencies</option> (or <option>-D</option>)</term>
+<term><option><link linkend="cmdline-include-dependencies">--include-dependencies</link></option> (or <option>-d</option>), <option>--no-include-dependencies</option> (or <option>-D</option>)</term>
<listitem><para>
This option causes &kdesrc-build; to automatically include other &kde; and &Qt;
modules in the build, if required for the modules you have requested to build
@@ -47,7 +47,7 @@ management system. See <xref linkend="kde-projects-module-sets"/>.</para>
</varlistentry>
<varlistentry id="cmdline-ignore-modules">
-<term><option>--ignore-modules</option> (or <option>-!</option>) <parameter>module [module ...]</parameter></term>
+<term><option><link linkend="cmdline-ignore-modules">--ignore-modules</link></option> (or <option>-!</option>) <parameter>module [module ...]</parameter></term>
<listitem><para>
Do not include the modules passed on the rest of the command line in the
update/build process (this is useful if you want to build most of the modules
@@ -57,7 +57,7 @@ a few).
</varlistentry>
<varlistentry id="cmdline-run">
-<term><option>--run</option> (or <option>--start-program</option>) <parameter>program [parameters ...]</parameter></term>
+<term><option><link linkend="cmdline-run">--run</link></option> (or <option>--start-program</option>) <parameter>program [parameters ...]</parameter></term>
<listitem><para>
This option interprets the next item on the command line as a program to run,
and &kdesrc-build; will then finish reading the configuration file, update the
@@ -86,7 +86,7 @@ QMAIL_CONTROLDIR=/var/qmail/control
</varlistentry>
<varlistentry id="cmdline-revision">
-<term><option>--revision</option> <replaceable>id</replaceable></term>
+<term><option><link linkend="cmdline-revision">--revision</link></option> <replaceable>id</replaceable></term>
<listitem><para>
This option causes &kdesrc-build; to checkout a specific numbered revision
for each &git; module, overriding any <link linkend="conf-branch">branch</link>,
@@ -99,7 +99,7 @@ compatibility with older scripts.
</varlistentry>
<varlistentry id="cmdline-delete-my-patches">
-<term><option>--delete-my-patches</option>, <option>--no-delete-my-patches</option></term>
+<term><option><link linkend="cmdline-delete-my-patches">--delete-my-patches</link></option>, <option>--no-delete-my-patches</option></term>
<listitem><para>
This option is used to let &kdesrc-build; delete source directories that may
contain user data, so that the module can be re-downloaded. This would normally
@@ -112,7 +112,7 @@ deleted).</para>
</varlistentry>
<varlistentry id="cmdline-delete-my-settings">
-<term><option>--delete-my-settings</option>, <option>--no-delete-my-settings</option></term>
+<term><option><link linkend="cmdline-delete-my-settings">--delete-my-settings</link></option>, <option>--no-delete-my-settings</option></term>
<listitem><para>
This option is used to let &kdesrc-build; overwrite existing files which may contain
user data.</para>
@@ -123,8 +123,8 @@ with it if it is needed.</para>
</listitem>
</varlistentry>
-<varlistentry id="cmdline-global-option">
-<term><option>--<replaceable><option-name></replaceable></option> <replaceable>value</replaceable></term>
+<varlistentry id="cmdline-option-name">
+<term><option><link linkend="cmdline-option-name">--<replaceable><option-name></replaceable></link></option> <replaceable>value</replaceable></term>
<listitem><para>
You can use this option to override an option in your <link linkend="configure-data">configuration file</link> for
every module. For instance, to override the <link
@@ -143,8 +143,8 @@ preferred by &kdesrc-build;.
</listitem>
</varlistentry>
-<varlistentry id="cmdline-module-option">
-<term><option>--set-module-option-value <replaceable><module-name></replaceable>,<replaceable><option-name></replaceable>,<replaceable><option-value></replaceable></option></term>
+<varlistentry id="cmdline-set-module-option-value">
+<term><option><link linkend="cmdline-set-module-option-value">--set-module-option-value</link> <replaceable><module-name></replaceable>,<replaceable><option-name></replaceable>,<replaceable><option-value></replaceable></option></term>
<listitem><para>
You can use this option to override an option in your <link linkend="configure-data">configuration file</link> for
a specific module.
@@ -159,7 +159,7 @@ a specific module.
<variablelist>
<varlistentry id="cmdline-resume-from">
-<term><option>--resume-from</option> (or <option>--from</option> or <option>-f</option>) <replaceable>module</replaceable></term>
+<term><option><link linkend="cmdline-resume-from">--resume-from</link></option> (or <option>--from</option> or <option>-f</option>) <replaceable>module</replaceable></term>
<listitem><para>This option is used to resume the build starting from the given module. You should not
specify other module names on the command line.
</para>
@@ -176,7 +176,7 @@ build.</para></listitem>
</varlistentry>
<varlistentry id="cmdline-resume-after">
-<term><option>--resume-after</option> (or <option>--after</option> or <option>-a</option>) <replaceable>module</replaceable></term>
+<term><option><link linkend="cmdline-resume-after">--resume-after</link></option> (or <option>--after</option> or <option>-a</option>) <replaceable>module</replaceable></term>
<listitem><para>
This option is used to resume the build starting after the given module. You should not
specify other module names on the command line.
@@ -195,7 +195,7 @@ module.</para></listitem>
</varlistentry>
<varlistentry id="cmdline-resume">
-<term><option>--resume</option></term>
+<term><option><link linkend="cmdline-resume">--resume</link></option></term>
<listitem><para>
This option can be used to run &kdesrc-build; after it has had a build failure.
@@ -211,7 +211,7 @@ building the modules you were building before, without fiddling with
</varlistentry>
<varlistentry id="cmdline-stop-before">
-<term><option>--stop-before</option> (or <option>--until</option>) <replaceable>module</replaceable></term>
+<term><option><link linkend="cmdline-stop-before">--stop-before</link></option> (or <option>--until</option>) <replaceable>module</replaceable></term>
<listitem><para>
This option is used to stop the normal build process just
<emphasis>before</emphasis> a module would ordinarily be built.
@@ -224,7 +224,7 @@ then <option>--stop-before <replaceable>moduleB</replaceable></option> would cau
</varlistentry>
<varlistentry id="cmdline-stop-after">
-<term><option>--stop-after</option> (or <option>--to</option>) <replaceable>module</replaceable></term>
+<term><option><link linkend="cmdline-stop-after">--stop-after</link></option> (or <option>--to</option>) <replaceable>module</replaceable></term>
<listitem><para>
This option is used to stop the normal build process just
<emphasis>after</emphasis> a module would ordinarily be built.
@@ -237,7 +237,7 @@ then <option>--stop-after <replaceable>moduleB</replaceable></option> would caus
</varlistentry>
<varlistentry id="cmdline-stop-on-failure">
-<term><option>--stop-on-failure</option>, <option>--no-stop-on-failure</option></term>
+<term><option><link linkend="cmdline-stop-on-failure">--stop-on-failure</link></option>, <option>--no-stop-on-failure</option></term>
<listitem><para>
This option controls if the build will be aborted as soon as a failure occurs.
Default behavior is --stop-on-failure. You may override it if you wish to press on with the rest of the modules in the build,
@@ -248,7 +248,7 @@ See also the <link linkend="conf-stop-on-failure">stop-on-failure</link> configu
</varlistentry>
<varlistentry id="cmdline-rebuild-failures">
-<term><option>--rebuild-failures</option></term>
+<term><option><link linkend="cmdline-rebuild-failures">--rebuild-failures</link></option></term>
<listitem><para>
Use this option to build only those modules which failed to build on a previous
&kdesrc-build; run. This is useful if a significant number of failures occurred mixed with
@@ -271,7 +271,7 @@ work.</para></note>
<variablelist>
<varlistentry id="cmdline-query">
-<term><option>--query</option> <userinput><replaceable>mode</replaceable></userinput></term>
+<term><option><link linkend="cmdline-query">--query</link></option> <userinput><replaceable>mode</replaceable></userinput></term>
<listitem><para>
This command causes &kdesrc-build; to query a parameter of the modules in the
build list (either passed on the command line or read in from the configuration
@@ -326,7 +326,7 @@ kdepim: master
<varlistentry id="cmdline-print-modules">
-<term><option>--print-modules</option></term>
+<term><option><link linkend="cmdline-print-modules">--print-modules</link></option></term>
<listitem>
<para>
Takes all actions up to and including dependency reordering of the modules
@@ -356,7 +356,7 @@ kdepim: master
</varlistentry>
<varlistentry id="cmdline-list-build">
-<term><option>--list-build</option></term>
+<term><option><link linkend="cmdline-list-build">--list-build</link></option></term>
<listitem>
<para>
Lists the modules that would be built, in the order in which they would be built.
@@ -373,7 +373,7 @@ kdepim: master
</varlistentry>
<varlistentry id="cmdline-dependency-tree">
-<term><option>--dependency-tree</option></term>
+<term><option><link linkend="cmdline-dependency-tree">--dependency-tree</link></option></term>
<listitem>
<para>
Prints out dependency information on the modules that would be built using a tree
@@ -385,7 +385,7 @@ kdepim: master
</varlistentry>
<varlistentry id="cmdline-dependency-tree-fullpath">
-<term><option>--dependency-tree-fullpath</option></term>
+<term><option><link linkend="cmdline-dependency-tree-fullpath">--dependency-tree-fullpath</link></option></term>
<listitem>
<para>
Prints out dependency information on the modules that would be built using a tree
@@ -403,7 +403,7 @@ kdepim: master
<variablelist>
<varlistentry id="cmdline-no-metadata">
-<term><option>--no-metadata</option></term>
+<term><option><link linkend="cmdline-no-metadata">--no-metadata</link></option></term>
<listitem><para>
Do not automatically download the extra metadata needed for &kde; git modules.
The source updates for the modules themselves will still occur unless you pass
@@ -418,21 +418,21 @@ one time and then using this option for subsequent runs.
</varlistentry>
<varlistentry id="cmdline-no-src">
-<term><option>--no-src</option> (or <option>-S</option>)</term>
+<term><option><link linkend="cmdline-no-src">--no-src</link></option> (or <option>-S</option>)</term>
<listitem><para>
Skip contacting the &git; server.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-no-build">
-<term><option>--no-build</option></term>
+<term><option><link linkend="cmdline-no-build">--no-build</link></option></term>
<listitem><para>
Skip the build process.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-no-install">
-<term><option>--no-install</option></term>
+<term><option><link linkend="cmdline-no-install">--no-install</link></option></term>
<listitem><para>
Do not automatically install packages after they are built.
</para></listitem>
@@ -446,7 +446,7 @@ Do not automatically install packages after they are built.
<variablelist>
<varlistentry id="cmdline-metadata-only">
-<term><option>--metadata-only</option></term>
+<term><option><link linkend="cmdline-metadata-only">--metadata-only</link></option></term>
<listitem><para>
Only perform the metadata download process. &kdesrc-build; normally handles this
automatically, but you might manually use this to allow the <option><link
@@ -455,21 +455,21 @@ linkend="cmdline-pretend">--pretend</link></option> command line option to work.
</varlistentry>
<varlistentry id="cmdline-src-only">
-<term><option>--src-only</option> (or <option>-s</option>)</term>
+<term><option><link linkend="cmdline-src-only">--src-only</link></option> (or <option>-s</option>)</term>
<listitem><para>
Only perform the source update.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-build-only">
-<term><option>--build-only</option></term>
+<term><option><link linkend="cmdline-build-only">--build-only</link></option></term>
<listitem><para>
Only perform the build process.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-install-only">
-<term><option>--install-only</option></term>
+<term><option><link linkend="cmdline-install-only">--install-only</link></option></term>
<listitem><para>
If this is the only command-line option, it tries to install all the modules
contained in <filename>log/latest/build-status</filename>. If command-line
@@ -480,7 +480,7 @@ the last run).
</varlistentry>
<varlistentry id="cmdline-build-system-only">
-<term><option>--build-system-only</option></term>
+<term><option><link linkend="cmdline-build-system-only">--build-system-only</link></option></term>
<listitem><para>
This option causes &kdesrc-build; to abort building a module just before
the <command>make</command> command would have been run. This is supported
@@ -497,7 +497,7 @@ the current &kde; build system.
<variablelist>
<varlistentry id="cmdline-build-when-unchanged">
-<term><option>--build-when-unchanged</option> (or <option>--force-build</option>), <option>--no-build-when-unchanged</option> (or <option>--no-force-build</option>)</term>
+<term><option><link linkend="cmdline-build-when-unchanged">--build-when-unchanged</link></option> (or <option>--force-build</option>), <option>--no-build-when-unchanged</option> (or <option>--no-force-build</option>)</term>
<listitem><para>
Enabling this option explicitly disables skipping the build process (an optimization
controlled by the <link
@@ -508,14 +508,14 @@ that &kdesrc-build; cannot check. This option is enabled by default.</para>
</varlistentry>
<varlistentry id="cmdline-refresh-build">
-<term><option>--refresh-build</option> (or <option>-r</option>)</term>
+<term><option><link linkend="cmdline-refresh-build">--refresh-build</link></option> (or <option>-r</option>)</term>
<listitem><para>
Recreate the build system and make from scratch.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-reconfigure">
-<term><option>--reconfigure</option></term>
+<term><option><link linkend="cmdline-reconfigure">--reconfigure</link></option></term>
<listitem><para>
Run <command>cmake</command> (for &kde; modules) or
<command>configure</command> (for &Qt;) again, without cleaning the build
@@ -527,7 +527,7 @@ linkend="cmdline-refresh-build">--refresh-build</link></parameter> is used.
</varlistentry>
<varlistentry id="cmdline-install-dir">
-<term><option>--install-dir <replaceable>path</replaceable></option></term>
+<term><option><link linkend="cmdline-install-dir">--install-dir</link> <replaceable>path</replaceable></option></term>
<listitem><para>
This allows you to change the directory where modules will be installed to. This option implies <link
linkend="cmdline-reconfigure"><option>--reconfigure</option></link>,
@@ -537,7 +537,7 @@ may still be required.
</varlistentry>
<varlistentry id="cmdline-generate-vscode-project-config">
-<term><option>--generate-vscode-project-config</option>, <option>--no-generate-vscode-project-config</option></term>
+<term><option><link linkend="cmdline-generate-vscode-project-config">--generate-vscode-project-config</link></option>, <option>--no-generate-vscode-project-config</option></term>
<listitem><para>
Generate a <filename>.vscode</filename> directory with configurations for building and debugging
in Visual Studio Code. This option is disabled by default.
@@ -552,7 +552,7 @@ in Visual Studio Code. This option is disabled by default.
<variablelist>
<varlistentry id="cmdline-async">
-<term><option>--async</option>, <option>--no-async</option></term>
+<term><option><link linkend="cmdline-async">--async</link></option>, <option>--no-async</option></term>
<listitem><para>
Enables or disables the <link linkend="conf-async">asynchronous mode</link>, which can
perform the source code updates and module builds at the same time.
@@ -564,14 +564,14 @@ while running &kdesrc-build; try disabling it, and submitting a
</varlistentry>
<varlistentry id="cmdline-color">
-<term><option>--color</option> (or <option>--colorful-output</option>), <option>--no-color</option> (or <option>--no-colorful-output</option>)</term>
+<term><option><link linkend="cmdline-color">--color</link></option> (or <option>--colorful-output</option>), <option>--no-color</option> (or <option>--no-colorful-output</option>)</term>
<listitem><para>
Enable or disable colorful output. By default, this option is enabled for interactive terminals.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-nice">
-<term><option>--nice</option> (or <option>--niceness</option>) <replaceable>value</replaceable></term>
+<term><option><link linkend="cmdline-nice">--nice</link></option> (or <option>--niceness</option>) <replaceable>value</replaceable></term>
<listitem><para>
This value adjusts the computer CPU priority requested by &kdesrc-build;, and
should be in the range of 0-20. 0 is highest priority (because it is the
@@ -580,7 +580,7 @@ least <quote>nice</quote>), 20 is the lowest priority. This option defaults to 1
</varlistentry>
<varlistentry id="cmdline-rc-file">
-<term><option>--rc-file</option> <replaceable>file</replaceable></term>
+<term><option><link linkend="cmdline-rc-file">--rc-file</link></option> <replaceable>file</replaceable></term>
<listitem><para>
The file to read the configuration options from. The default value for this parameter is
<filename>kdesrc-buildrc</filename> (checked in the current working directory).
@@ -599,7 +599,7 @@ If this file doesn't exist, <filename>~/.config/kdesrc-buildrc</filename>
<variablelist>
<varlistentry id="cmdline-initial-setup">
-<term><option>--initial-setup</option></term>
+<term><option><link linkend="cmdline-initial-setup">--initial-setup</link></option></term>
<listitem><para>
Has &kdesrc-build; perform the one-time initial setup necessary to prepare
the system for &kdesrc-build; to operate, and for the newly-installed &kde;
@@ -620,7 +620,7 @@ software to run.
</varlistentry>
<varlistentry id="cmdline-install-distro-packages">
-<term><option>--install-distro-packages</option></term>
+<term><option><link linkend="cmdline-install-distro-packages">--install-distro-packages</link></option></term>
<listitem><para>
Installs distro packages (on supported &Linux; distributions) necessary to prepare the system for &kdesrc-build; to operate, and for the newly-installed &kde;
software to run.
@@ -630,7 +630,7 @@ software to run.
</varlistentry>
<varlistentry id="cmdline-generate-config">
-<term><option>--generate-config</option></term>
+<term><option><link linkend="cmdline-generate-config">--generate-config</link></option></term>
<listitem><para>
Generate the &kdesrc-build; configuration file.
</para>
@@ -639,7 +639,7 @@ Generate the &kdesrc-build; configuration file.
</varlistentry>
<varlistentry id="cmdline-update-shellrc">
-<term><option>--update-shellrc</option></term>
+<term><option><link linkend="cmdline-update-shellrc">--update-shellrc</link></option></term>
<listitem><para>
Edit the "~/.bashrc" (or other shell rc file) to add &kdesrc-build; to your <envar>$PATH</envar> variable and enable autocompletion.
</para>
@@ -659,7 +659,7 @@ Edit the "~/.bashrc" (or other shell rc file) to add &kdesrc-build; to your <env
<variablelist>
<varlistentry id="cmdline-debug">
-<term><option>--debug</option></term>
+<term><option><link linkend="cmdline-debug">--debug</link></option></term>
<listitem><para>
Enables debug mode for the script. Currently, this means that all output will be
dumped to the standard output in addition to being logged in the log directory
@@ -669,7 +669,7 @@ doing in debugging mode.
</varlistentry>
<varlistentry id="cmdline-quiet">
-<term><option>--quiet</option> (or <option>--quite</option> or <option>-q</option>)</term>
+<term><option><link linkend="cmdline-quiet">--quiet</link></option> (or <option>--quite</option> or <option>-q</option>)</term>
<listitem><para>
Do not be as noisy with the output. With this switch only the basics are
output.
@@ -677,14 +677,14 @@ output.
</varlistentry>
<varlistentry id="cmdline-really-quiet">
-<term><option>--really-quiet</option></term>
+<term><option><link linkend="cmdline-really-quiet">--really-quiet</link></option></term>
<listitem><para>
Only output warnings and errors.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-verbose">
-<term><option>--verbose</option></term>
+<term><option><link linkend="cmdline-verbose">--verbose</link></option></term>
<listitem><para>
Be very descriptive about what is going on, and what &kdesrc-build; is doing.
</para></listitem>
@@ -698,21 +698,21 @@ Be very descriptive about what is going on, and what &kdesrc-build; is doing.
<variablelist>
<varlistentry id="cmdline-version">
-<term><option>--version</option> (or <option>-v</option>)</term>
+<term><option><link linkend="cmdline-version">--version</link></option> (or <option>-v</option>)</term>
<listitem><para>
Display the program version.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-help">
-<term><option>--help</option> (or <option>-h</option>)</term>
+<term><option><link linkend="cmdline-help">--help</link></option> (or <option>-h</option>)</term>
<listitem><para>
Only display simple help on this script.
</para></listitem>
</varlistentry>
<varlistentry id="cmdline-show-info">
-<term><option>--show-info</option></term>
+<term><option><link linkend="cmdline-show-info">--show-info</link></option></term>
<listitem><para>
Displays information about &kdesrc-build; and the operating system, that may
prove useful in bug reports or when asking for help in forums or mailing lists.
@@ -721,7 +721,7 @@ prove useful in bug reports or when asking for help in forums or mailing lists.
</varlistentry>
<varlistentry id="cmdline-show-options-specifiers">
-<term><option>--show-options-specifiers</option></term>
+<term><option><link linkend="cmdline-show-options-specifiers">--show-options-specifiers</link></option></term>
<listitem><para>
Print the specifier lines (in the format that GetOpts::Long accepts) for all command line options supported by the script.
This may be used by developers, for example, for generating zsh autocompletion functions.
diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index da8b7da1..7ee10c94 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -31,7 +31,7 @@ option.</para></listitem>
<tbody>
<row id="conf-async">
-<entry>async</entry>
+<entry><link linkend="conf-async">async</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -44,7 +44,7 @@ all of the source code updates before starting the build process.</para></entry>
</row>
<row id="conf-colorful-output">
-<entry>colorful-output</entry>
+<entry><link linkend="conf-colorful-output">colorful-output</link></entry>
<entry><simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
<member>Default value</member><member>True</member>
@@ -56,7 +56,7 @@ color codes to anything but a terminal (such as xterm, &konsole;, or the normal
</row>
<row id="conf-disable-agent-check">
-<entry>disable-agent-check</entry>
+<entry><link linkend="conf-disable-agent-check">disable-agent-check</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -71,7 +71,7 @@ for every module.</para>
</row>
<row id="conf-git-desired-protocol">
-<entry>git-desired-protocol</entry>
+<entry><link linkend="conf-git-desired-protocol">git-desired-protocol</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -105,7 +105,7 @@ protocol is most efficient.</para>
</row>
<row id="conf-install-environment-driver">
-<entry>install-environment-driver</entry>
+<entry><link linkend="conf-install-environment-driver">install-environment-driver</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -141,7 +141,7 @@ command-line option.</para></tip>
</row>
<row id="conf-install-session-driver">
-<entry>install-session-driver</entry>
+<entry><link linkend="conf-install-session-driver">install-session-driver</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -171,7 +171,7 @@ command-line option.</para></tip>
</row>
<row id="conf-niceness">
-<entry>niceness</entry>
+<entry><link linkend="conf-niceness">niceness</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Integer</member>
@@ -184,7 +184,7 @@ number, the "nicer" the program is.</para>
</row>
<row id="conf-num-cores">
-<entry>num-cores</entry>
+<entry><link linkend="conf-num-cores">num-cores</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Integer</member>
@@ -202,7 +202,7 @@ option's usage.</para>
</row>
<row id="conf-num-cores-low-mem">
-<entry>num-cores-low-mem</entry>
+<entry><link linkend="conf-num-cores-low-mem">num-cores-low-mem</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Integer</member>
@@ -229,7 +229,7 @@ set to 2.</para>
</row>
<row id="conf-persistent-data-file">
-<entry>persistent-data-file</entry>
+<entry><link linkend="conf-persistent-data-file">persistent-data-file</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -249,7 +249,7 @@ so that different configurations do not end up with conflicting persistent data.
</row>
<row id="conf-ssh-identity-file">
-<entry>ssh-identity-file</entry>
+<entry><link linkend="conf-ssh-identity-file">ssh-identity-file</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -263,7 +263,7 @@ linkend="ssh-agent-reminder"/>.</para>
</row>
<row id="conf-use-idle-io-priority">
-<entry>use-idle-io-priority</entry>
+<entry><link linkend="conf-use-idle-io-priority">use-idle-io-priority</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -277,7 +277,7 @@ running times for &kdesrc-build;.</para>
</row>
<row id="conf-use-inactive-modules">
-<entry>use-inactive-modules</entry>
+<entry><link linkend="conf-use-inactive-modules">use-inactive-modules</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -307,7 +307,7 @@ running times for &kdesrc-build;.</para>
<tbody>
<row id="conf-binpath">
-<entry>binpath</entry>
+<entry><link linkend="conf-binpath">binpath</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -323,7 +323,7 @@ may use the tilde (~) for any paths you add using this option.</para>
</row>
<row id="conf-branch">
-<entry>branch</entry>
+<entry><link linkend="conf-branch">branch</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -337,7 +337,7 @@ option for case-by-case exceptions.</para></note>
</row>
<row id="conf-branch-group">
-<entry>branch-group</entry>
+<entry><link linkend="conf-branch-group">branch-group</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -373,7 +373,7 @@ linkend="kde-projects-module-sets"/>.
</row>
<row id="conf-build-dir">
-<entry>build-dir</entry>
+<entry><link linkend="conf-build-dir">build-dir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -408,7 +408,7 @@ class="directory">/home/user-name/builddir</filename>.</para></listitem>
</row>
<row id="conf-build-when-unchanged">
-<entry>build-when-unchanged</entry>
+<entry><link linkend="conf-build-when-unchanged">build-when-unchanged</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -435,7 +435,7 @@ change at all.</para></important>
</row>
<row id="conf-cmake-generator">
-<entry>cmake-generator</entry>
+<entry><link linkend="conf-cmake-generator">cmake-generator</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -454,7 +454,7 @@ value for <literal>cmake-generator</literal>.</para></entry>
</row>
<row id="conf-cmake-toolchain">
-<entry>cmake-toolchain</entry>
+<entry><link linkend="conf-cmake-toolchain">cmake-toolchain</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -474,7 +474,7 @@ value for <literal>cmake-toolchain</literal>.</para></entry>
</row>
<row id="conf-cmake-options">
-<entry>cmake-options</entry>
+<entry><link linkend="conf-cmake-options">cmake-options</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -516,7 +516,7 @@ are set for you automatically)</para></entry>
</row>
<row id="conf-compile-commands-export">
-<entry>compile-commands-export</entry>
+<entry><link linkend="conf-compile-commands-export">compile-commands-export</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -528,7 +528,7 @@ are set for you automatically)</para></entry>
</row>
<row id="conf-compile-commands-linking">
-<entry>compile-commands-linking</entry>
+<entry><link linkend="conf-compile-commands-linking">compile-commands-linking</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -541,7 +541,7 @@ inside the build directory to the matching source directory.
</row>
<row id="conf-configure-flags">
-<entry>configure-flags</entry>
+<entry><link linkend="conf-configure-flags">configure-flags</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -560,7 +560,7 @@ only works for qt.</emphasis></para>
</row>
<row id="conf-custom-build-command">
-<entry>custom-build-command</entry>
+<entry><link linkend="conf-custom-build-command">custom-build-command</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -580,7 +580,7 @@ only works for qt.</emphasis></para>
</row>
<row id="conf-cxxflags">
-<entry>cxxflags</entry>
+<entry><link linkend="conf-cxxflags">cxxflags</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -603,7 +603,7 @@ linkend="conf-cmake-options">cmake-options</link> option.
</row>
<row id="conf-dest-dir">
-<entry>dest-dir</entry>
+<entry><link linkend="conf-dest-dir">dest-dir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -619,7 +619,7 @@ or directory separators in the name as this will interfere with any
</row>
<row id="conf-do-not-compile">
-<entry>do-not-compile</entry>
+<entry><link linkend="conf-do-not-compile">do-not-compile</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -640,7 +640,7 @@ options.</para>
</row>
<row id="conf-git-user">
-<entry>git-user</entry>
+<entry><link linkend="conf-git-user">git-user</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -669,7 +669,7 @@ email address <quote>[email protected]</quote> would use:</para>
</row>
<row id="conf-http-proxy">
-<entry>http-proxy</entry>
+<entry><link linkend="conf-http-proxy">http-proxy</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -687,7 +687,7 @@ on also use that proxy server, if possible, by setting the
</row>
<row id="conf-directory-layout">
-<entry>directory-layout</entry>
+<entry><link linkend="conf-directory-layout">directory-layout</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -720,7 +720,7 @@ due to changes in the project metadata.</para>
</row>
<row id="conf-generate-vscode-project-config">
-<entry>generate-vscode-project-config</entry>
+<entry><link linkend="conf-generate-vscode-project-config">generate-vscode-project-config</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
@@ -747,7 +747,7 @@ for working on most KDE projects.</para>
</row>
<row id="conf-include-dependencies">
-<entry>include-dependencies</entry>
+<entry><link linkend="conf-include-dependencies">include-dependencies</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -769,7 +769,7 @@ common operating systems.</para>
</row>
<row id="conf-install-after-build">
-<entry>install-after-build</entry>
+<entry><link linkend="conf-install-after-build">install-after-build</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -783,7 +783,7 @@ flag.</para>
</row>
<row id="conf-install-dir">
-<entry>install-dir</entry>
+<entry><link linkend="conf-install-dir">install-dir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -804,7 +804,7 @@ in the path to have them expanded to the module's name.</para>
</row>
<row id="conf-libname">
-<entry>libname</entry>
+<entry><link linkend="conf-libname">libname</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -818,7 +818,7 @@ but if the guess is wrong then it can be changed with this setting.</para>
</row>
<row id="conf-libpath">
-<entry>libpath</entry>
+<entry><link linkend="conf-libpath">libpath</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -833,7 +833,7 @@ You may use the tilde (~) for any paths you add using this option.</para>
</row>
<row id="conf-log-dir">
-<entry>log-dir</entry>
+<entry><link linkend="conf-log-dir">log-dir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -844,7 +844,7 @@ generated by the script.</para>
</row>
<row id="conf-make-install-prefix">
-<entry>make-install-prefix</entry>
+<entry><link linkend="conf-make-install-prefix">make-install-prefix</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -856,7 +856,7 @@ please be careful while dealing with root privileges.</para></entry>
</row>
<row id="conf-make-options">
-<entry>make-options</entry>
+<entry><link linkend="conf-make-options">make-options</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -874,7 +874,7 @@ setting.</para>
</row>
<row id="conf-manual-build">
-<entry>manual-build</entry>
+<entry><link linkend="conf-manual-build">manual-build</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -893,7 +893,7 @@ command line option.
</row>
<row id="conf-manual-update">
-<entry>manual-update</entry>
+<entry><link linkend="conf-manual-update">manual-update</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -907,7 +907,7 @@ commented it out.</para>
</row>
<row id="conf-ninja-options">
-<entry>ninja-options</entry>
+<entry><link linkend="conf-ninja-options">ninja-options</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -938,7 +938,7 @@ end options
</row>
<row id="conf-no-src">
-<entry>no-src</entry>
+<entry><link linkend="conf-no-src">no-src</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -951,7 +951,7 @@ module if it normally would have tried anyways.</para>
</row>
<row id="conf-override-build-system">
-<entry>override-build-system</entry>
+<entry><link linkend="conf-override-build-system">override-build-system</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1006,7 +1006,7 @@ the auto-detection. In this case you can manually specify the correct build type
</row>
<row id="conf-purge-old-logs">
-<entry>purge-old-logs</entry>
+<entry><link linkend="conf-purge-old-logs">purge-old-logs</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -1018,7 +1018,7 @@ deleted or not.</para>
</row>
<row id="conf-qmake-options">
-<entry>qmake-options</entry>
+<entry><link linkend="conf-qmake-options">qmake-options</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1034,7 +1034,7 @@ installs the module.
</row>
<row id="conf-qtdir">
-<entry>qtdir</entry>
+<entry><link linkend="conf-qtdir">qtdir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1047,7 +1047,7 @@ provided by the operating system.
</row>
<row id="conf-remove-after-install">
-<entry>remove-after-install</entry>
+<entry><link linkend="conf-remove-after-install">remove-after-install</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1074,7 +1074,7 @@ since &kdesrc-build; will be unable to perform incremental builds.</para>
</row>
<row id="conf-repository">
-<entry>repository</entry>
+<entry><link linkend="conf-repository">repository</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1087,7 +1087,7 @@ specify the &git; repository to download the source code for the module.
</row>
<row id="conf-revision">
-<entry>revision</entry>
+<entry><link linkend="conf-revision">revision</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1103,7 +1103,7 @@ configuration.</para>
</row>
<row id="conf-run-tests">
-<entry>run-tests</entry>
+<entry><link linkend="conf-run-tests">run-tests</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -1117,7 +1117,7 @@ to ensure their system is setup correctly.</para></entry>
</row>
<row id="conf-set-env">
-<entry>set-env</entry>
+<entry><link linkend="conf-set-env">set-env</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1137,7 +1137,7 @@ globally).</para>
</row>
<row id="conf-source-dir">
-<entry>source-dir</entry>
+<entry><link linkend="conf-source-dir">source-dir</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1150,7 +1150,7 @@ to represent the home directory if using this option.</para>
</row>
<row id="conf-stop-on-failure">
-<entry>stop-on-failure</entry>
+<entry><link linkend="conf-stop-on-failure">stop-on-failure</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -1162,7 +1162,7 @@ after an error occurs during the build or install process.</para>
</row>
<row id="conf-tag">
-<entry>tag</entry>
+<entry><link linkend="conf-tag">tag</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1177,7 +1177,7 @@ url="https://download.kde.org/">&kde; download site</ulink>.</para>
</row>
<row id="conf-use-clean-install">
-<entry>use-clean-install</entry>
+<entry><link linkend="conf-use-clean-install">use-clean-install</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>Boolean</member>
@@ -1214,7 +1214,7 @@ installations. However this only works on build systems that support
<tbody>
<row id="conf-git-repository-base">
-<entry>git-repository-base</entry>
+<entry><link linkend="conf-git-repository-base">git-repository-base</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1274,7 +1274,7 @@ different module sets.</para></tip>
</row>
<row id="conf-ignore-modules">
-<entry>ignore-modules</entry>
+<entry><link linkend="conf-ignore-modules">ignore-modules</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>
@@ -1305,7 +1305,7 @@ is compared).</para>
</row>
<row id="conf-use-modules">
-<entry>use-modules</entry>
+<entry><link linkend="conf-use-modules">use-modules</link></entry>
<entry>
<simplelist type='horiz' columns='2'>
<member>Type</member><member>String</member>