Add support for random package ordering in build task module

2 files changed, 66 insertions, 10 deletions

diff --git a/etc/brep-module.conf b/etc/brep-module.conf
index 22d82de..31e3e11 100644
--- a/etc/brep-module.conf
+++ b/etc/brep-module.conf
@@ -124,6 +124,13 @@ menu About=?about
 # build-interactive-login
 
 
+# Order in which packages are considered for build. The valid values are
+# 'stable' and 'random'. If not specified, then 'stable' is assumed. Note that
+# interactive builds are always preferred.
+#
+#build-package-order stable
+
+
 # Number of builds per page.
 #
 # build-page-entries 20
diff --git a/etc/private/install/brep-module.conf b/etc/private/install/brep-module.conf
index 0bff58d..832b8c1 100644
--- a/etc/private/install/brep-module.conf
+++ b/etc/private/install/brep-module.conf
@@ -112,6 +112,25 @@ menu About=?about
 # build-bot-agent-keys
 
 
+# Regular expressions in the /<regex>/<replacement>/ form for transforming the
+# interactive build login information, for example, into the actual command
+# that can be used by the user. The regular expressions are matched against
+# the "<agent> <interactive-login>" string containing the respective task
+# request manifest values. The first matching expression is used for the
+# transformation. If no expression matches, then the task request is
+# considered invalid, unless no expressions are specified. Repeat this option
+# to specify multiple expressions.
+#
+# build-interactive-login
+
+
+# Order in which packages are considered for build. The valid values are
+# 'stable' and 'random'. If not specified, then 'stable' is assumed. Note that
+# interactive builds are always preferred.
+#
+#build-package-order stable
+
+
 # Number of builds per page.
 #
 # build-page-entries 20
@@ -128,16 +147,20 @@ menu About=?about
 # build-forced-rebuild-timeout 600
 
 
-# Time to wait before considering a package for a normal rebuild. Must be
-# specified in seconds. Default is 24 hours.
+# Time to wait before considering a package for a soft rebuild (only to be
+# performed if the build environment or any of the package dependencies have
+# changed). Must be specified in seconds. The special zero value disables soft
+# rebuilds. Default is 24 hours.
 #
-# build-normal-rebuild-timeout 86400
+# build-soft-rebuild-timeout 86400
 
 
-# Alternative package rebuild timeout to use instead of the normal rebuild
-# timeout (see the build-normal-rebuild-timeout option for details) during
-# the specified time interval. Must be specified in seconds. Default is the
-# time interval length.
+# Alternative package soft rebuild timeout to use instead of the soft rebuild
+# timeout (see the build-soft-rebuild-timeout option for details) during the
+# specified time interval. Must be specified in seconds. Default is the time
+# interval length plus (build-soft-rebuild-timeout - 24h) if soft rebuild
+# timeout is greater than 24 hours (thus the rebuild is only triggered within
+# the last 24 hours of the build-soft-rebuild-timeout expiration).
 #
 # The alternative rebuild timeout can be used to "pull" the rebuild window to
 # the specified time of day, for example, to optimize load and/or power
@@ -157,9 +180,25 @@ menu About=?about
 # times must both be either specified or absent. If unspecified, then no
 # alternative rebuild timeout will be used.
 #
-# build-alt-rebuild-timeout
-# build-alt-rebuild-start
-# build-alt-rebuild-stop
+# build-alt-soft-rebuild-timeout
+# build-alt-soft-rebuild-start
+# build-alt-soft-rebuild-stop
+
+
+# Time to wait before considering a package for a hard rebuild (to be
+# performed unconditionally). Must be specified in seconds. The special zero
+# value disables hard rebuilds. Default is 7 days.
+#
+# build-hard-rebuild-timeout 604800
+
+
+# Alternative package hard rebuild timeout. The semantics is the same as for
+# the build-alt-soft-rebuild-* options but for the build-hard-rebuild-timeout
+# option.
+#
+# build-alt-hard-rebuild-timeout
+# build-alt-hard-rebuild-start
+# build-alt-hard-rebuild-stop
 
 
 # The maximum size of the build task request manifest accepted. Note that the
@@ -183,6 +222,16 @@ menu About=?about
 # build-result-request-max-size 10485760
 
 
+# Enable or disable package build notification emails in the <name>=<bool>
+# form. If true is specified for a toolchain name, then emails are sent
+# according to the build-*email package manifest values when the package is
+# built with this toolchain. If false is specified, then no emails are sent
+# for this toolchain name. By default build notification emails are enabled.
+# Repeat this option to enable/disable emails for multiple toolchains.
+#
+# build-toolchain-email <toolchain-name>=true|false
+
+
 # The build database connection configuration. By default, brep will try to
 # connect to the local instance of PostgreSQL with the operating system-default
 # mechanism (Unix-domain socket, etc) and use operating system (login) user