[sdk/kdesrc-build/docbook_historied_per_file] doc: Correct documentation regarding --resume-foo.
Michael Pyne
null at kde.org
Fri May 10 10:15:11 BST 2024
Git commit f0bc683f56aa4130797d48d6028dd1256090eee4 by Michael Pyne.
Committed on 23/02/2011 at 03:45.
Pushed by ashark into branch 'docbook_historied_per_file'.
Correct documentation regarding --resume-foo.
Original commit: 45128e86
https://invent.kde.org/sdk/kdesrc-build/-/commit/45128e86d0ebb66ef3531416f49e2ac24615ea47
M +18 -4 doc/cmdline/supported-cmdline-params.docbook
M +4 -2 doc/using-kdesrc-build/advanced-features.docbook
https://invent.kde.org/sdk/kdesrc-build/-/commit/f0bc683f56aa4130797d48d6028dd1256090eee4
diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index 7a3e1e0f..181b1428 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -216,10 +216,17 @@ linkend="cmdline-refresh-build">--refresh-build</link></parameter> is used.
<term><parameter>--resume-from</parameter></term>
<listitem><para>
This option is used to resume the build starting from the given module, which
-should be the next option on the command line. This option implies <link
-linkend="cmdline-no-src"><parameter>--no-src</parameter></link>. You should not
+should be the next option on the command line. You should not
specify other module names on the command line.
</para>
+
+<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>
+in addition to the other options.
+</para></note>
+
<para>See also: <xref linkend="cmdline-resume-after"/> and <xref
linkend="resuming-failed"/>. You would prefer to use this command line option
if you have fixed the build error and want &kdesrc-build; to complete the
@@ -230,10 +237,17 @@ build.</para></listitem>
<term><parameter>--resume-after</parameter></term>
<listitem><para>
This option is used to resume the build starting after the given module, which
-should be the next option on the command line. This option implies <link
-linkend="cmdline-no-src"><parameter>--no-src</parameter></link>. You should not
+should be the next option on the command line. You should not
specify other module names on the command line.
</para>
+
+<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>
+in addition to the other options.
+</para></note>
+
<para>See also: <xref linkend="cmdline-resume-from"/> and <xref
linkend="resuming-failed"/>. You would prefer to use this command line option
if you have fixed the build error and have also built and installed the module
diff --git a/doc/using-kdesrc-build/advanced-features.docbook b/doc/using-kdesrc-build/advanced-features.docbook
index 37e14d06..fd1deaa6 100644
--- a/doc/using-kdesrc-build/advanced-features.docbook
+++ b/doc/using-kdesrc-build/advanced-features.docbook
@@ -327,8 +327,10 @@ than it normally would. This can be useful when a set of modules failed, or
if you canceled a build run in the middle. You can control this using the
&cmd-resume-from; option and the &cmd-resume-after; option.</para>
-<note><para>Using either of the resume options will skip the source code
-update.</para> </note>
+<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
+to skip the source update.</para></note>
<informalexample>
<para>Resuming the build starting from kdebase:</para>
More information about the kde-doc-english
mailing list