Add support for automatic creation of configurations for build-time dependencies

1 files changed, 18 insertions, 0 deletions

diff --git a/bdep/sync.cli b/bdep/sync.cli
index 07c46a2..86c6095 100644
--- a/bdep/sync.cli
+++ b/bdep/sync.cli
@@ -67,6 +67,13 @@ namespace bdep
      Note also that \c{\b{--immediate}|\b{-i}} or \c{\b{--recursive}|\b{-r}}
      can only be specified with an explicit \cb{--upgrade} or \cb{--patch}.
 
+     If during synchronization a build-time dependency is encountered and
+     there is no build configuration of a suitable type associated with the
+     project, then the user is prompted (unless the respective
+     \cb{--create-*-config} option is specified) to automatically create such
+     a configuration and associate it with the project. See
+     \l{bpkg-cfg-create(1)} for background on configuration types.
+
      \h|EXAMPLES|
 
      As an example, consider project \cb{prj} with two packages, \cb{foo}
@@ -205,6 +212,17 @@ namespace bdep
       "Don't prompt for confirmation when up/down-grading dependencies."
     }
 
+    bool --create-host-config
+    {
+      "Create a configuration for build-time dependencies without prompt."
+    }
+
+    bool --create-build2-config
+    {
+      "Create a configuration for build system module dependencies without
+       prompt."
+    }
+
     bool --implicit
     {
       "Perform implicit synchronization. This mode is normally used by other