[sdk/kdesrc-build/docbook_historied_per_file] doc/cmdline: Support invoking initial setup steps separately

[Thiago Sueto]

Git commit e615a6cbef8e81b5d37c7f0a374542d19dac526b by Thiago Sueto, on behalf of Andrew Shark.
Committed on 23/11/2023 at 15:57.
Pushed by ashark into branch 'docbook_historied_per_file'.

Support invoking initial setup steps separately

Related to https://invent.kde.org/sdk/kdesrc-build/-/issues/132

Original commit: 7e1ceafd
https://invent.kde.org/sdk/kdesrc-build/-/commit/7e1ceafd61b754fc55186d95fd4e241482c10361

M  +32   -1    doc/cmdline/supported-cmdline-params.docbook

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

diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index 79fe89cc..db549d02 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -54,8 +54,39 @@ software to run.
 <listitem><para>Adding required environment variables to <literal>~/.bashrc</literal></para></listitem>
 <listitem><para>Setting up a <link linkend="setup-rcfile">configuration file</link></para></listitem>
 </itemizedlist>
+<para>This option is exactly equivalent to using
+    <option><link linkend="cmdline-install-distro-packages">--install-distro-packages</link></option>
+    <option><link linkend="cmdline-generate-config">--generate-config</link></option>
+    <option><link linkend="cmdline-update-shellrc">--update-shellrc</link></option> at the same time.
+</para>
+</listitem>
+</varlistentry>
 
-<para>Available since version 18.11.</para>
+<varlistentry id="cmdline-install-distro-packages">
+<term><parameter>--install-distro-packages</parameter></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.
+</para>
+<para>See also <option><link linkend="cmdline-initial-setup">--initial-setup</link></option></para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="cmdline-generate-config">
+<term><parameter>--generate-config</parameter></term>
+<listitem><para>
+Generate the &kdesrc-build; configuration file.
+</para>
+<para>See also <option><link linkend="cmdline-initial-setup">--initial-setup</link></option></para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="cmdline-update-shellrc">
+<term><parameter>--update-shellrc</parameter></term>
+<listitem><para>
+Edit the "~/.bashrc" (or other shell rc file) to add &kdesrc-build; to your $PATH variable and enable autocompletion.
+</para>
+<para>See also <option><link linkend="cmdline-initial-setup">--initial-setup</link></option></para>
 </listitem>
 </varlistentry>