[sdk/kdesrc-build/docbook_historied_per_file] doc: GIT_SILENT doc: Minor tag usage cleanups (silent)
Michael Pyne
null at kde.org
Fri May 10 10:15:11 BST 2024
Git commit 3b8afbfadb585cf18e54de5749b3ece1f195b82d by Michael Pyne.
Committed on 07/09/2011 at 20:48.
Pushed by ashark into branch 'docbook_historied_per_file'.
GIT_SILENT doc: Minor tag usage cleanups
Original commit: 24158198
https://invent.kde.org/sdk/kdesrc-build/-/commit/241581982a5d92f07af4e3c2248b7d3e564db36c
M +2 -2 doc/cmdline/supported-cmdline-params.docbook
M +11 -11 doc/kdesrc-buildrc/conf-options-table.docbook
M +8 -8 doc/using-kdesrc-build/advanced-features.docbook
M +1 -1 doc/using-kdesrc-build/developer-features.docbook
M +1 -1 doc/using-kdesrc-build/other-features.docbook
https://invent.kde.org/sdk/kdesrc-build/-/commit/3b8afbfadb585cf18e54de5749b3ece1f195b82d
diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index cbf3599c..2c435608 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -223,7 +223,7 @@ specify other module names on the command line.
<note><para>This option formerly added <link
linkend="cmdline-no-src"><parameter>--no-src</parameter></link>, but does
not any longer (since &kdesrc-build; 1.13). If you want to avoid source updates
-when resuming, simply pass <option><replaceable>--no-src</replaceable></option>
+when resuming, simply pass <option><userinput>--no-src</userinput></option>
in addition to the other options.
</para></note>
@@ -244,7 +244,7 @@ specify other module names on the command line.
<note><para>This option formerly added <link
linkend="cmdline-no-src"><parameter>--no-src</parameter></link>, but does
not any longer (since &kdesrc-build; 1.13). If you want to avoid source updates
-when resuming, simply pass <option><replaceable>--no-src</replaceable></option>
+when resuming, simply pass <option><userinput>--no-src</userinput></option>
in addition to the other options.
</para></note>
diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 224db878..1734ae23 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -59,7 +59,7 @@ linkend="conf-repository">repository</link> option.</entry>
<entry><para>This option enables the asynchronous mode of operation, where the source
code update and the build process will be performed in parallel, instead of waiting for
all of the source code updates before starting the build process. This option defaults
-to enabling asynchronous mode. To disable, set this option to <replaceable>false</replaceable></para>
+to enabling asynchronous mode. To disable, set this option to <userinput>false</userinput></para>
<para>This option is available since the 1.6 release.</para></entry>
</row>
@@ -131,13 +131,13 @@ Perhaps surprisingly, this option can be changed per module.
tries to build a module that has not had any source code updates.</para>
<para>By setting <option>build-when-unchanged</option> to
-<replaceable>true</replaceable>, &kdesrc-build; always attempts the build phase
+<userinput>true</userinput>, &kdesrc-build; always attempts the build phase
for a module, even if the module did not have any source code updates. This is
the default setting since it is more likely to lead to a correct
build.</para>
<para>By setting <option>build-when-unchanged</option> to
-<replaceable>false</replaceable>, &kdesrc-build; will only attempt to run the
+<userinput>false</userinput>, &kdesrc-build; will only attempt to run the
build phase for a module if the module has a source code update, or in other
situations where it is likely that a rebuild is actually required. This can save
time, especially if you run &kdesrc-build; daily, or more frequently.</para>
@@ -192,7 +192,7 @@ are set for you automatically)</para></entry>
<row id="conf-colorful-output">
<entry>colorful-output</entry>
<entry>Cannot be overridden</entry>
-<entry>Set this option to <replaceable>false</replaceable> to disable the colorful output of &kdesrc-build;.
+<entry>Set this option to <userinput>false</userinput> to disable the colorful output of &kdesrc-build;.
This option defaults to <replaceable>true</replaceable>. Note that &kdesrc-build; will not output the
color codes to anything but a terminal (such as xterm, &konsole;, or the normal
&Linux; console).
@@ -250,7 +250,7 @@ or directory separators in the name as this will interfere with any
make sure that if you are using ssh-agent, it is actually managing some &ssh;
identities. This is to try and prevent &ssh; from asking for your pass phrase
for every module. You can disable this check by setting
-<option>disable-agent-check</option> to <replaceable>true</replaceable>.
+<option>disable-agent-check</option> to <userinput>true</userinput>.
</entry>
</row>
@@ -363,7 +363,7 @@ different module sets.</para></tip>
<entry>Module setting overrides global</entry>
<entry>This option is used to install the package after it successfully builds.
This option is enabled by default. If you want to disable this, you need to set
-this option to <replaceable>false</replaceable> in the <link
+this option to <userinput>false</userinput> in the <link
linkend="configure-data">configuration file</link>. You can also use the <link
linkend="cmdline-no-install"><option>--no-install</option></link> command line
flag.
@@ -446,7 +446,7 @@ systems with more than one processor core.
<row id="conf-manual-build">
<entry>manual-build</entry>
<entry>Module setting overrides global</entry>
-<entry>Set the option value to <replaceable>true</replaceable> to keep the
+<entry>Set the option value to <userinput>true</userinput> to keep the
build process from attempting to build this module. It will still be kept
up-to-date when updating from &subversion;. This option is exactly equivalent
to the <link linkend="cmdline-no-build"><option>--no-build</option></link>
@@ -457,7 +457,7 @@ command line option.
<row id="conf-manual-update">
<entry>manual-update</entry>
<entry>Module setting overrides global</entry>
-<entry>Set the option value to <replaceable>true</replaceable> to keep the
+<entry>Set the option value to <userinput>true</userinput> to keep the
build process from attempting to update (and by extension, build or install)
this module. If you set this option for a module, then you have essentially
commented it out.
@@ -598,7 +598,7 @@ configuration.</entry>
<row id="conf-run-tests">
<entry>run-tests</entry>
<entry>Module setting overrides global</entry>
-<entry>If set to <replaceable>true</replaceable>, then the module will be
+<entry>If set to <userinput>true</userinput>, then the module will be
built with support for running its test suite, and the test suite will be
executed as part of the build process. &kdesrc-build; will show a simple
report of the test results. This is useful for developers or those who want
@@ -633,7 +633,7 @@ to represent the home directory if using this option.
<row id="conf-stop-on-failure">
<entry>stop-on-failure</entry>
<entry>Module setting overrides global</entry>
-<entry>Set this option value to <replaceable>true</replaceable> to cause the script to stop execution
+<entry>Set this option value to <userinput>true</userinput> to cause the script to stop execution
after an error occurs during the build or install process. This option is off
by default.
</entry>
@@ -676,7 +676,7 @@ require &cmake;, and &cmake; use is not permitted on any other modules.
to be used for disk and other I/O usage, which can significantly improve the
responsiveness of the rest of the system at the expense of slightly longer
running times for &kdesrc-build;. The default is to be disabled, to enable
-the lower disk priority set this to <replaceable>true</replaceable>.
+the lower disk priority set this to <userinput>true</userinput>.
</entry>
</row>
diff --git a/doc/using-kdesrc-build/advanced-features.docbook b/doc/using-kdesrc-build/advanced-features.docbook
index 77b49c54..a2068400 100644
--- a/doc/using-kdesrc-build/advanced-features.docbook
+++ b/doc/using-kdesrc-build/advanced-features.docbook
@@ -281,8 +281,8 @@ If you change the setting of the &build-dir; option, then use that instead of
<informalexample>
<para>Rebuild using <filename>.refresh-me</filename> for module <replaceable>kdelibs</replaceable>:</para>
<screen>
-<prompt>%</prompt> <userinput><command>touch</command> <filename class="directory">~/kdesrc/build/<replaceable>kdelibs</replaceable>.refresh-me</filename></userinput>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command></userinput>
+<prompt>%</prompt> <userinput><command>touch</command> <filename>~/kdesrc/build/<replaceable>kdelibs</replaceable>/.refresh-me</filename></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command></userinput>
</screen>
</informalexample>
</sect3>
@@ -329,14 +329,14 @@ if you canceled a build run in the middle. You can control this using the
<note><para>Older versions of &kdesrc-build; would skip the source update when
resuming a build. This is no longer done by default, but you can always use
-the <option><replaceable>--no-src</replaceable></option> command line option
+the <option>--no-src</option> command line option
to skip the source update.</para></note>
<informalexample>
<para>Resuming the build starting from kdebase:</para>
<screen>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--resume-from=<replaceable>kdebase</replaceable></option></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--resume-from=<replaceable>kdebase</replaceable></option></userinput>
</screen>
</informalexample>
@@ -345,7 +345,7 @@ to skip the source update.</para></note>
the issue and installed the module yourself):</para>
<screen>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--resume-after=<replaceable>kdebase</replaceable></option></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--resume-after=<replaceable>kdebase</replaceable></option></userinput>
</screen>
</informalexample>
@@ -365,7 +365,7 @@ performing the update and build.</para>
<informalexample>
<para>Ignoring extragear/multimedia and kdereview during a full run:</para>
<screen>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--ignore-modules</option> <replaceable>extragear/multimedia kdereview</replaceable></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--ignore-modules</option> <replaceable>extragear/multimedia kdereview</replaceable></userinput>
</screen>
</informalexample>
@@ -394,7 +394,7 @@ any setting from the configuration file.</para>
testing:</para>
<screen>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--pretend</option> <option>--<replaceable>source-dir</replaceable>=<replaceable>/dev/null</replaceable></option></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--pretend</option> <option>--<replaceable>source-dir</replaceable>=<replaceable>/dev/null</replaceable></option></userinput>
</screen>
</informalexample>
@@ -414,7 +414,7 @@ syntax is similar: --<replaceable>module</replaceable>,<replaceable>option-name<
<para>Using a different build directory for the kdeedu module:</para>
<screen>
-<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--<replaceable>kdeedu</replaceable>,<replaceable>build-dir</replaceable>=<replaceable>temp-build</replaceable></option></userinput>
+<prompt>%</prompt> <userinput><command>kdesrc-build</command> <option>--<replaceable>kdeedu</replaceable>,<replaceable>build-dir</replaceable>=<replaceable>temp-build</replaceable></option></userinput>
</screen>
</informalexample>
diff --git a/doc/using-kdesrc-build/developer-features.docbook b/doc/using-kdesrc-build/developer-features.docbook
index cbe86744..c7b51177 100644
--- a/doc/using-kdesrc-build/developer-features.docbook
+++ b/doc/using-kdesrc-build/developer-features.docbook
@@ -19,7 +19,7 @@ handle passwords for the second possible protocol for &kde; developers, https.
<para>You may wish to disable the &ssh; Agent check, in case of situations where
&kdesrc-build; is mis-detecting the presence of an agent. To disable the
agent check, set the <option>disable-agent-check</option> option to
-<replaceable>true</replaceable>.</para>
+<userinput>true</userinput>.</para>
<informalexample>
<para>Disabling the &ssh; agent check:</para>
diff --git a/doc/using-kdesrc-build/other-features.docbook b/doc/using-kdesrc-build/other-features.docbook
index c5c44cd3..02f8e209 100644
--- a/doc/using-kdesrc-build/other-features.docbook
+++ b/doc/using-kdesrc-build/other-features.docbook
@@ -35,7 +35,7 @@ will normally display with colorized text.</para>
<para>You can disable this by using the <option>--no-color</option> on the
command line, or by setting the &colorful-output; option in the <link linkend="configure-data">configuration file</link> to
-<replaceable>false</replaceable>.
+<userinput>false</userinput>.
</para>
<informalexample>
More information about the kde-doc-english
mailing list