From b7ff8f89cea055e75881e716d8358ffa4d7779af Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Mon, 27 Sep 2021 11:09:51 +0300
Subject: Add support for soft and hard rebuilds

---
 monitor/monitor.cli | 36 +++++++++++++++++++++++++++---------
 1 file changed, 27 insertions(+), 9 deletions(-)

(limited to 'monitor/monitor.cli')

diff --git a/monitor/monitor.cli b/monitor/monitor.cli
index edfc004..3a58a1d 100644
--- a/monitor/monitor.cli
+++ b/monitor/monitor.cli
@@ -60,18 +60,26 @@ namespace brep
     {
       "\h|OPTIONS|"
 
-      std::size_t --build-timeout
+      std::size_t --soft-rebuild-timeout
       {
         "<seconds>",
-        "Time to wait (in seconds) before considering a package build as
+        "Time to wait (in seconds) before considering a package soft (re)build as
          delayed. If unspecified, it is the sum of the package rebuild timeout
-         (normal rebuild timeout if the alternative timeout is unspecified and
-         the maximum of two otherwise) and the build result timeout (see the
-         \cb{build-normal-rebuild-timeout}, \cb{build-alt-rebuild-*}, and
-         \cb{build-result-timeout} \c{brep} module configuration options
-         for details).
-
-         Note that a package that was not built before it was archived is
+         (soft rebuild timeout if the alternative timeout is unspecified and
+         the maximum of two otherwise) and the build result timeout (see
+         the \cb{build-soft-rebuild-timeout}, \cb{build-alt-soft-rebuild-*},
+         and \cb{build-result-timeout} \cb{brep} module configuration options
+         for details). The special zero value disables monitoring of soft
+         rebuilds.
+
+         Note that if both soft and hard rebuilds are disabled in the
+         \cb{brep} module configuration, then \cb{brep-monitor} is unable to
+         come up with a reasonable build timeout on its own. In this case, to
+         monitor the initial package build delays, you may need to specify
+         either \cb{--soft-rebuild-timeout} or \cb{--hard-rebuild-timeout}
+         explicitly.
+
+         Also note that a package that was not built before it was archived is
          always considered as delayed. However, to distinguish this case from
          a situation where a package was archived before a configuration have
          been added, \cb{brep-monitor} needs to observe the package as
@@ -81,6 +89,16 @@ namespace brep
          timeout."
       }
 
+      std::size_t --hard-rebuild-timeout
+      {
+        "<seconds>",
+        "Time to wait (in seconds) before considering a package hard (re)build
+         as delayed. If unspecified, it is calculated in the same way as for
+         \cb{--soft-rebuild-timeout} but using the
+         \cb{build-hard-rebuild-timeout} and \cb{build-alt-hard-rebuild-*}
+         \cb{brep} module configuration options."
+      }
+
       std::size_t --report-timeout
       {
         "<seconds>",
-- 
cgit v1.1