From d38f564abaf6fcbc6c7cf2922f3e8f4c8327362f Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Mon, 27 Mar 2023 08:46:58 +0200
Subject: Add append/prepend support to pkg-bindist
 --{debian,archive}-build-meta

---
 bpkg/pkg-bindist.cli | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

(limited to 'bpkg/pkg-bindist.cli')

diff --git a/bpkg/pkg-bindist.cli b/bpkg/pkg-bindist.cli
index c9a89da..fd2a197 100644
--- a/bpkg/pkg-bindist.cli
+++ b/bpkg/pkg-bindist.cli
@@ -259,7 +259,10 @@ namespace bpkg
     string --debian-build-meta
     {
       "<data>",
-      "Alternative build metadata to include in the binary package version.
+      "Alternative or additional build metadata to include in the binary
+       package version. If the specified value starts/ends with \cb{+} then
+       the value (with \cb{+} removed) is added after/before the default
+       metadata. Otherwise it is used as is instead of the default metadata.
        If empty value is specified, then no build metadata is included. By
        default, the build metadata is the \cb{ID} and \cb{VERSION_ID}
        components from \cb{os-release(5)}, for example, \cb{debian10} in
@@ -568,8 +571,9 @@ namespace bpkg
      details on the mapping semantics.
 
      Instead of mapping languages individually you can specify entire build
-     metadata as a single value with the \cb{--archive-build-meta}, for
-     example:
+     metadata as a single value with the \cb{--archive-build-meta} (it is also
+     possible to add additional metadata; see the option documentation for
+     details). For example:
 
      \
      bpkg bindist                              \
@@ -695,9 +699,12 @@ namespace bpkg
     string --archive-build-meta
     {
       "<data>",
-      "Alternative build metadata to include after the version in the binary
-       package directory and file names. If empty value is specified, then no
-       build metadata is included."
+      "Alternative or additional build metadata to include after the version
+       in the binary package directory and file names. If the specified value
+       starts/ends with \cb{+} then the value (with \cb{+} removed) is added
+       after/before the default metadata. Otherwise it is used as is instead
+       of the default metadata. If empty value is specified, then no build
+       metadata is included."
     }
 
     dir_path --archive-install-root
-- 
cgit v1.1