From 2c39ac617baeef96882efc3c4d0babeb5d74a7d2 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Mon, 22 Jan 2024 22:39:11 +0300
Subject: Fix bbot worker not to perform pkg.install, bpkg.bindist.*, etc steps
 for non-installable packages (GH issue #334)

---
 doc/manual.cli | 44 ++++++++++++++++++++++++++++----------------
 1 file changed, 28 insertions(+), 16 deletions(-)

(limited to 'doc')

diff --git a/doc/manual.cli b/doc/manual.cli
index c584b2c..41f0eeb 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1094,7 +1094,8 @@ bpkg -v update <package-name>
   bpkg -v test <package-name>
 }
 
-# If config.install.root is specified and no
+# If the install operation is supported by the package,
+# config.install.root is specified, and no
 # bpkg.bindist.{debian,fedora,archive} step is enabled:
 #
 {
@@ -1111,7 +1112,8 @@ bpkg -v update <package-name>
   }
 }
 
-# If bpkg.bindist.{debian,fedora,archive} step is enabled:
+# If the install operation is supported by the package and
+# bpkg.bindist.{debian,fedora,archive} step is enabled:
 #
 {
   # bpkg.bindist.{debian,fedora,archive}
@@ -1121,7 +1123,8 @@ bpkg -v update <package-name>
        <package-name>
 }
 
-# If bbot.sys-install step is enabled:
+# If the install operation is supported by the package and
+# bbot.sys-install step is enabled:
 #
 {
   # If <distribution> is 'debian':
@@ -1274,7 +1277,8 @@ bpkg -v update <package-name>
   bpkg -v uninstall <package-name>
 }
 
-# If bbot.bindist.upload step is enabled:
+# If the install operation is supported by the package and
+# bbot.bindist.upload step is enabled:
 #
 {
   # Move the generated binary distribution files to the
@@ -1470,8 +1474,9 @@ bpkg -v update -d <host-conf> <package-name>
   bpkg -v test -d <target-conf> <package-name>
 }
 
-# If configuration is self-hosted, config.install.root is specified,
-# and no bpkg.bindist.{debian,fedora,archive} step is enabled:
+# If configuration is self-hosted, the install operation is supported
+# by the package, config.install.root is specified, and no
+# bpkg.bindist.{debian,fedora,archive} step is enabled:
 #
 {
   # bpkg.install
@@ -1487,8 +1492,9 @@ bpkg -v update -d <host-conf> <package-name>
   }
 }
 
-# If configuration is self-hosted and
-# bpkg.bindist.{debian,fedora,archive} step is enabled:
+# If configuration is self-hosted, the install operation is supported
+# by the package, and bpkg.bindist.{debian,fedora,archive} step is
+# enabled:
 #
 {
   # bpkg.bindist.{debian,fedora,archive}
@@ -1498,7 +1504,8 @@ bpkg -v update -d <host-conf> <package-name>
        <package-name>
 }
 
-# If bbot.sys-install step is enabled:
+# If the install operation is supported by the package and
+# bbot.sys-install step is enabled:
 #
 {
   # If <distribution> is 'debian':
@@ -1698,7 +1705,8 @@ bpkg -v update -d <host-conf> <package-name>
   bpkg -v uninstall -d <install-conf> <package-name>
 }
 
-# If bbot.bindist.upload step is enabled:
+# If the install operation is supported by the package and
+# bbot.bindist.upload step is enabled:
 #
 {
   # Move the generated binary distribution files to the
@@ -1866,8 +1874,9 @@ bpkg -v update -d <module-conf> <package-name>
   bpkg -v test -d <target-conf> <package-name>
 }
 
-# If configuration is self-hosted, config.install.root is specified,
-# and no bpkg.bindist.{debian,fedora,archive} step is enabled:
+# If configuration is self-hosted, the install operation is supported
+# by the package, config.install.root is specified, and no
+# bpkg.bindist.{debian,fedora,archive} step is enabled:
 #
 {
   # bpkg.install
@@ -1883,8 +1892,9 @@ bpkg -v update -d <module-conf> <package-name>
   }
 }
 
-# If configuration is self-hosted and
-# bpkg.bindist.{debian,fedora,archive} step is enabled:
+# If configuration is self-hosted, the install operation is supported
+# by the package, and bpkg.bindist.{debian,fedora,archive} step is
+# enabled:
 #
 {
   # bpkg.bindist.{debian,fedora,archive}
@@ -1894,7 +1904,8 @@ bpkg -v update -d <module-conf> <package-name>
        <package-name>
 }
 
-# If bbot.sys-install step is enabled:
+# If the install operation is supported by the package and
+# bbot.sys-install step is enabled:
 #
 {
   # If <distribution> is 'debian':
@@ -2046,7 +2057,8 @@ bpkg -v update -d <module-conf> <package-name>
   bpkg -v uninstall -d <install-conf> <package-name>
 }
 
-# If bbot.bindist.upload step is enabled:
+# If the install operation is supported by the package and
+# bbot.bindist.upload step is enabled:
 #
 {
   # Move the generated binary distribution files to the
-- 
cgit v1.1