aboutsummaryrefslogtreecommitdiff
path: root/bpkg/cfg-create.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2019-06-04 13:38:11 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2019-06-04 13:38:11 +0200
commitca650053f66bb4b9f4f1de87aa41e8353bc97e1c (patch)
treeaa4a43f9c8f8fbab5bcb4403249ebc10c2ef8adc /bpkg/cfg-create.cli
parentd49a65fa7153aaade24d02b3af5fc21d4bf7dd79 (diff)
Add --existing|-e option to bpkg-cfg-create
With this option cfg-create initializes a bpkg configuration based on an existing build system configuration instead of creating a new one.
Diffstat (limited to 'bpkg/cfg-create.cli')
-rw-r--r--bpkg/cfg-create.cli31
1 files changed, 20 insertions, 11 deletions
diff --git a/bpkg/cfg-create.cli b/bpkg/cfg-create.cli
index bac601d..571c614 100644
--- a/bpkg/cfg-create.cli
+++ b/bpkg/cfg-create.cli
@@ -16,25 +16,28 @@ namespace bpkg
"\h|SYNOPSIS|
- \c{\b{bpkg cfg-create}|\b{create} [<options>] [<cfg-args>]}
+ \c{\b{bpkg cfg-create}|\b{create} [<options>] [<cfg-args>]\n
+ \b{bpkg cfg-create}|\b{create} [<options>] \b{--existing|-e}}
\c{<cfg-args> = (<module> | <cfg-var>)...}
\h|DESCRIPTION|
The \cb{cfg-create} command creates a new \cb{bpkg} configuration with
- the specified \cb{build2} modules and configuration variables. The
- \cb{bpkg} configuration itself is a build system configuration; see
- build system driver (\l{b(1)}) \cb{create} meta-operation for details.
+ the specified \cb{build2} modules and configuration variables (the first
+ form) or initializes one based on an existing build system configuration
+ (the second form). The \cb{bpkg} configuration itself is a build system
+ configuration; see build system driver (\l{b(1)}) \cb{create}
+ meta-operation for details.
- Unless the \cb{--wipe} option is specified, \cb{cfg-create} expects the
- configuration directory to be empty or to not exist (in which case it
- will be created).
+ Unless the \cb{--existing|-e} or \cb{--wipe} option is specified,
+ \cb{cfg-create} expects the configuration directory to be empty or to not
+ exist (in which case it will be created).
- By default, the resulting configuration loads the \cb{config}, \cb{test},
- \cb{dist}, and \cb{install} modules. However, additional modules and, if
- required, their configuration variables can be specified as the
- \cb{cfg-create} arguments. For example:
+ By default, the configuration created with the first form loads the
+ \cb{config}, \cb{test}, \cb{dist}, and \cb{install} modules. However,
+ additional modules and, if required, their configuration variables can be
+ specified as the \cb{cfg-create} arguments. For example:
\
bpkg create cxx config.cxx=clang++ config.install.root=/usr/local
@@ -63,6 +66,12 @@ namespace bpkg
directory."
}
+ bool --existing|-e
+ {
+ "Initialize a \cb{bpkg} configuration based on an existing build system
+ configuration."
+ }
+
bool --wipe
{
"Wipe the configuration directory clean before creating the new