Git commit 19044150a44a2f7a18d89a1e74dbcc0b5f696c6e by Andrew Shark.
Committed on 20/02/2024 at 21:29.
Pushed by ashark into branch 'master'.
doc: List --run in commonly used options
Reference full documentation from --help. No need to keep yet another place of
options listing.
M +54 -42 doc/cmdline.docbook
M +6-69 modules/ksb/Cmdline.pm
https://invent.kde.org/sdk/kdesrc-build/-/commit/19044150a44a2f7a18d89a1e74dbcc0b5f696c6e
diff --git a/doc/cmdline.docbook b/doc/cmdline.docbook
index a3380279..0ad480d0 100644
--- a/doc/cmdline.docbook
+++ b/doc/cmdline.docbook
@@ -17,48 +17,6 @@ kdesrc-build will build all modules defined in its
configuration file, in the
order listed in that file (although this can be modified by various
configuration file options).
-
-Commonly used command line options
-
-The full list of command line options is given in . The most-commonly used options
-include:
-
-
-
---pretend (or -p)
-This option causes to indicate what actions
-it would take, without actually really implementing them. This can be
-useful to make sure that the modules you think you are building will
-actually get built.
-
-
-
---refresh-build
-This option forces to build the given
-modules from an absolutely fresh start point. Any existing build directory
-for that module is removed and it is rebuilt. This option is useful if you
-have errors building a module, and sometimes is required when or
-libraries change.
-
-
-
---no-src
-This option skips the source update process. You might use
-it if you have very recently updated the source code (perhaps you did it
-manually or recently ran ) but still want to rebuild some
-modules.
-
-
-
---no-build
-This option is similar to --no-src above,
-but this time the build process is skipped.
-
-
-
-
-
Specifying modules to build
@@ -96,6 +54,60 @@ option before building a new module set to ensure it is only
building the
modules you want.
+
+
+Commonly used command line options
+
+
+
+--pretend (or -p)
+This option causes to indicate what
actions
+ it would take, without actually really implementing them. This can be
+ useful to make sure that the modules you think you are building will
+ actually get built.
+
+
+
+--no-src
+This option skips the source update process. You might
use
+ it if you have very recently updated the source code (perhaps you
did it
+ manually or recently ran ) but still want to rebuild
some
+ modules.
+
+
+
+--no-include-dependencies (or
-D)
+Only process the selected modules, skipping their
dependencies.
+ Useful when you have changed only selected modules, and you are sure
you
+ do not need to rebuild the others.
+
+
+
+--refresh-build (or -r)
+This option forces to build the given
+ modules from an absolutely fresh start point. Any existing build
directory
+ for that module is removed and it is rebuilt. This option is useful
if you
+ have errors building a module, and sometimes is required when
or
+ libraries change.
+
+
+
+--resume-from module
+Skips modules until just before the given module, then
operates as normal.
+ Useful when the previous build failed on specific module, you fixed
it, and then you
+ want to continue the with building the rest of initial set of
modules.
+
+
+
+--run module
+Launch the built application.
+
+
+
+ The full list of command line options is given in .
+
+
diff --git a/modules/ksb/Cmdline.pm b/modules/ksb/Cmdline.pm
index cb1666e4..a935286a 100644
--- a/modules/ksb/Cmdline.pm
+++ b/modules/ksb/Cmdline.pm
@@ -323,77 +323,14 @@ sub _showVersionAndExit
sub _showHelpAndExit
{
-# According to XDG spec, if $XDG_CONFIG_HOME is not set, then we should
-# default to ~/.config
-my $xdgConfigHome = $ENV{XDG_CONFIG_HOME} // "$ENV{HOME}/.config";
-my $xdgConfigHomeShort = $xdgConfigHome =~ s/^$ENV{HOME}/~/r; # Replace
$HOME with ~
-
-my $pwd = $ENV{PWD};
-my $pwdShort = $pwd =~ s/^$ENV{HOME}/~/r; # Replace $HOME with ~
-
-my $scriptVersion = scriptVersion();
-
say <<~DONE;
-kdesrc-build $scriptVersion
-Copyright (c) 2003 - 2023 Michael Pyne and others,
and is
-distributed under the terms of the GNU GPL v2.
-
-This script automates the download, build, and install process for KDE
software
-using the latest available source code.
-
-Configuration is controlled from "$pwdShort/kdesrc-buildrc" or
-"$xdgConfigHomeShort/kdesrc-buildrc".
-See kdesrc-buildrc-sample for an example.
-
-Usage: \$ $0 [--options] [module names]
-