aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2023-09-29 14:18:03 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2023-10-02 16:44:55 +0300
commit0729fb20fc28329012ee3e9ec68b280d329f4cb4 (patch)
tree9e899f54935a8bb1868037f0785ecf69b31c565d /doc
parentfed6c765fac5aaa412cf676d8907a63db52a5a63 (diff)
Document *-build-*email package manifest values in manual
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli34
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index ded60d9..999d924 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1090,6 +1090,10 @@ license: <licenses> [; <comment>]
[*-build-include]: <config>[/<target>] [; <comment>]
[*-build-exclude]: <config>[/<target>] [; <comment>]
+[*-build-email]: <email> [; <comment>]
+[*-build-warning-email]: <email> [; <comment>]
+[*-build-error-email]: <email> [; <comment>]
+
[build-file]: <path>
[bootstrap-build]: <text>
@@ -2343,6 +2347,10 @@ Note that the comment of the matching exclusion is used by the web interface
[*-builds]: <class-expr> [; <comment>]
[*-build-include]: <config>[/<target>] [; <comment>]
[*-build-exclude]: <config>[/<target>] [; <comment>]
+
+[*-build-email]: <email> [; <comment>]
+[*-build-warning-email]: <email> [; <comment>]
+[*-build-error-email]: <email> [; <comment>]
\
The package build configurations where the substring matched by \c{*} in
@@ -2427,6 +2435,32 @@ Note that the common build target configurations set is overridden
hierarchically meaning that the \c{*-build-{include, exclude\}} overrides
don't discard the common \c{builds} values.
+The package build configuration can also override the common build
+notification email addresses (specified with \l{#manifest-package-build-email
+\c{build-email}}, \l{#manifest-package-warning-email \c{build-warning-email}},
+and \l{#manifest-package-error-email \c{build-error-email}}) by specifying the
+matching \c{*-build-email} and/or \c{*-build-{warning, error\}-email} values.
+For example:
+
+\
+bindist-build-config:
+\\
++bpkg.bindist.debian:--recursive=full
++bbot.bindist.upload:
+;
+Generate and upload binary distribution package.
+\\
+bindist-build-error-email: builds@example.org
+\
+
+Note that to disable all the build notification emails for a specific package
+build configuration, specify the empty \c{*-build-email} value. For example:
+
+\
+sys-build-config: ?sys:libz; Test with system dependencies.
+sys-build-email:
+\
+
The default configuration should normally build the package with no
configuration arguments and for the common target build configurations
set. While not recommended, this can be overridden by using the special