[sdk/kdesrc-build/docbook_historied_per_file] doc: Add --stop-{before,after} command line options.

[Michael Pyne]

Git commit b109e05d3eb833c384114cb07856a51099f29416 by Michael Pyne.
Committed on 20/02/2013 at 04:23.
Pushed by ashark into branch 'docbook_historied_per_file'.

Add --stop-{before,after} command line options.

Should hopefully be pretty much what it says on the tin. Stop either
right before or right after the given module. (GUI flag since this
involves documentation changes to the Handbook and man page).

BUG:315251
FIXED-IN:1.16
GUI:

Original commit: f3d30fb5
https://invent.kde.org/sdk/kdesrc-build/-/commit/f3d30fb5a056f297181aa63d66af5f92f45b2635

M  +30   -0    doc/cmdline/supported-cmdline-params.docbook
M  +4    -3    doc/index.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/b109e05d3eb833c384114cb07856a51099f29416

diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index cc2498ba..346c495f 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -255,6 +255,36 @@ yourself, and want &kdesrc-build; to start again with the next
 module.</para></listitem>
 </varlistentry>
 
+<varlistentry id="cmdline-stop-before">
+<term><parameter>--stop-before</parameter></term>
+<listitem><para>
+This command line option is used to stop the normal build process just
+<emphasis>before</emphasis> a module would ordinarily be built.
+</para><para>
+For example, if the normal build list was <simplelist type='inline'>
+<member>moduleA</member><member>moduleB</member><member>moduleC</member></simplelist>,
+then <option>--stop-before=<replaceable>moduleB</replaceable></option> would cause
+&kdesrc-build; to only build <literal>moduleA</literal>.
+</para><para>
+This command line option was added with &kdesrc-build; 1.16.
+</para></listitem>
+</varlistentry>
+
+<varlistentry id="cmdline-stop-after">
+<term><parameter>--stop-after</parameter></term>
+<listitem><para>
+This command line option is used to stop the normal build process just
+<emphasis>after</emphasis> a module would ordinarily be built.
+</para><para>
+For example, if the normal build list was <simplelist type='inline'>
+<member>moduleA</member><member>moduleB</member><member>moduleC</member></simplelist>,
+then <option>--stop-after=<replaceable>moduleB</replaceable></option> would cause
+&kdesrc-build; to build <literal>moduleA</literal> and <literal>moduleB</literal>.
+</para><para>
+This command line option was added with &kdesrc-build; 1.16.
+</para></listitem>
+</varlistentry>
+
 <varlistentry id="cmdline-rc-file">
 <term><parameter>--rc-file</parameter></term>
 <listitem><para>
diff --git a/doc/index.docbook b/doc/index.docbook
index 934ab40c..54285e39 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -2,7 +2,7 @@
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   <!--
     Documentation for kdesrc-build.
-    Copyright (c) 2005-2008, 2010-2012 Michael Pyne <mpyne at kde.org>
+    Copyright (c) 2005-2008, 2010-2013 Michael Pyne <mpyne at kde.org>
 
     Copyright (c) 2005 Carlos Leonhard Woelz <carloswoelz at imap-mail.com>
     Copyright (c) 2009 Burkhard Lück <lueck at hube-lueck.de>
@@ -129,6 +129,7 @@
 <year>2010</year>
 <year>2011</year>
 <year>2012</year>
+<year>2013</year>
 <holder>Michael Pyne</holder>
 </copyright>
 
@@ -139,8 +140,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2012-05-05</date>
-<releaseinfo>1.15</releaseinfo>
+<date>2013-02-19</date>
+<releaseinfo>1.16</releaseinfo>
 
 <abstract>
 <para>&kdesrc-build; is a script which builds and installs &kde; software