From 03c40ed68ce10b26a5f9f509e914b1b54f060215 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Sat, 4 Sep 2021 15:41:41 +0300
Subject: Add --backlink, --dangling, and --recursive options to cfg-info

---
 bpkg/cfg-info.cli | 33 ++++++++++++++++++++++++++++-----
 1 file changed, 28 insertions(+), 5 deletions(-)

(limited to 'bpkg/cfg-info.cli')

diff --git a/bpkg/cfg-info.cli b/bpkg/cfg-info.cli
index 8002abd..8801ec9 100644
--- a/bpkg/cfg-info.cli
+++ b/bpkg/cfg-info.cli
@@ -19,14 +19,22 @@ namespace bpkg
      \h|DESCRIPTION|
 
      The \cb{cfg-info} command prints the current configuration's absolute
-     path, id, type, and name. If the \cb{--link} option is specified then
-     this information is also printed for each linked configuration, if any.
+     path, id, type, and name. If the \cb{--link} and/or \cb{--backlink}
+     options are specified, then this information is also printed for each
+     linked and/or implicitly backlinked configuration, if any. Note that the
+     dangling implicit backlinks are silently skipped, unless \cb{--dangling}
+     is specified, in which case this information is also printed for them.
      Note that the information is written to \cb{stdout}, not \cb{stderr}.
 
+     If the \cb{--recursive} option is specified together with \cb{--link}
+     and/or \cb{--backlink}, then this information is printed for linked
+     and/or implicitly backlinked configuration, recursively.
+
      The output format is regular with each value printed on a separate line
-     and prefixed with the value name. If the \cb{--link} option is specified
-     then information blocks corresponding to configurations are separated
-     with blank lines. For example:
+     and prefixed with the value name. If the \cb{--link}, \cb{--backlink},
+     and/or \cb{--dangling} options are specified, then information blocks
+     corresponding to linked configurations are separated with blank
+     lines. For example:
 
      \
      path: /path/to/cfg/
@@ -55,6 +63,21 @@ namespace bpkg
     {
       "Print linked configurations."
     }
+
+    bool --backlink
+    {
+      "Print implicitly backlinked configurations."
+    }
+
+    bool --dangling
+    {
+      "Print dangling implicit backlinks."
+    }
+
+    bool --recursive
+    {
+      "Print linked configurations recursively."
+    }
   };
 
   "
-- 
cgit v1.1