From 9ffd711094b68d8ce5bb464621020ccc993d787c Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Thu, 15 Mar 2018 13:08:45 +0200
Subject: Add --immediate|-i and --recursive|-r to pkg-status for dependencies

---
 bpkg/pkg-status.cli | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

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

diff --git a/bpkg/pkg-status.cli b/bpkg/pkg-status.cli
index 6aa971e..6157c4d 100644
--- a/bpkg/pkg-status.cli
+++ b/bpkg/pkg-status.cli
@@ -13,6 +13,9 @@ namespace bpkg
   {
     "<options> <pkg> <ver>",
 
+    // NOTE: remember to update <dep-spec> in bdep-status if changing the
+    //       argument format.
+    //
     "\h|SYNOPSIS|
 
      \c{\b{bpkg pkg-status}|\b{status} [<options>] [<pkg>[\b{/}<ver>]...]}
@@ -23,8 +26,11 @@ namespace bpkg
      or, if <ver> is specified, package versions. If no packages were
      specified, then \cb{pkg-status} prints the status of all the held
      packages (which are the packages that were explicitly built; see
-     \l{bpkg-pkg-build(1)}). Note that the status is written to \cb{STDOUT},
-     not \cb{STDERR}.
+     \l{bpkg-pkg-build(1)}). Additionally, the status of immediate or all
+     dependencies of the above packages can be printed by specifying the
+     \c{\b{--immediate}|\b{-i}} or \c{\b{--recursive}|\b{-r}} options,
+     respectively. Note that the status is written to \cb{STDOUT}, not
+     \cb{STDERR}.
 
      The status output format is regular. If several packages were specified,
      then each line starts with the package name (and version, if specified)
@@ -136,5 +142,15 @@ namespace bpkg
   class pkg_status_options: configuration_options
   {
     "\h|PKG-STATUS OPTIONS|"
+
+    bool --immediate|-i
+    {
+      "Also print the status of immediate dependencies."
+    }
+
+    bool --recursive|-r
+    {
+      "Also print the status of all dependencies, recursively."
+    }
   };
 }
-- 
cgit v1.1