diff options
| -rw-r--r-- | bdep/sync.cli | 86 |
1 files changed, 68 insertions, 18 deletions
diff --git a/bdep/sync.cli b/bdep/sync.cli index 1c97ac8..79bb91d 100644 --- a/bdep/sync.cli +++ b/bdep/sync.cli @@ -68,34 +68,84 @@ namespace bdep └── libfoo/ \ - The following invocations illustrate the common \cb{sync} use cases (the - current working directory is shown before the shell prompt): + Assuming \cb{foo} and \cb{libfoo} have been initialized in the default + build configuration, the following invocations illustrate the common + \cb{sync} use cases (the current working directory is shown before the + shell prompt). + + Synchronize \cb{foo} and \cb{libfoo} with the default configuration: + + \ + prj/$ bdep sync \ - prj/$ bdep sync # Synchronize foo/ and libfoo/ with the - # default configuration. + The same (all initialized packages in a project are always synchronized + at once): + + \ prj/$ cd foo - foo/$ bdep sync # The same (all packages in a project are - # always synchronized together). + foo/$ bdep sync + \ + + Add a dependency on \cb{libx} with \cb{sync} fetching and configuring a + suitable version: + + \ + foo/$ edit manifest # Add 'depends: libx >= 1.0.0' + foo/$ bdep sync + \ + + Upgrade all the immediate dependencies of \cb{foo}: + + \ + foo/$ bdep sync -u + \ - foo/$ edit manifest # Add 'depends: libx >= 1.0.0' - foo/$ bdep sync # Fetch and configure suitable libx version. + Upgrade all the dependencies of all the initialzied packages in a + project recursively: - foo/$ bdep sync -u # Upgrade all immediate dependencies of foo. + \ foo/$ cd ../ - prj/$ bdep sync -u -r # Upgrade all dependencies of all packages in - # a project recursively. + prj/$ bdep sync -u -r + \ + + Upgrade \cb{libx} to the latest version: + + \ + prj/$ bdep sync libx + \ + + Upgrade \cb{libx} and its immediate dependecies to the latest version: + + \ + prj/$ bdep sync -i libx + \ + + Upgrade \cb{libx} to the latest patch version: + + \ + prj/$ bdep sync -p libx + \ - prj/$ bdep sync libx # Upgrade libx to the latest version. - prj/$ bdep sync -i libx # ...and its immediate dependecies. + Upgrade \cb{libx} and all its dependecies recursively to the latest patch + version. - prj/$ bdep sync -p libx # Upgrade libx to the latest patch. - prj/$ bdep sync -p -r libx # ...and its dependecies recursively. + \ + prj/$ bdep sync -p -r libx + \ - prj/$ bdep sync libx/1.2.3 # Upgrade libx to version 1.2.3. - prj/$ bdep sync -p -r libx/1.2.3 # ...and patch its dependecies, - # recursively. + Upgrade \cb{libx} to version \cb{1.2.3}. + + \ + prj/$ bdep sync libx/1.2.3 + \ + + Upgrade \cb{libx} to version \cb{1.2.3} and patch all its dependecies, + recursively: + + \ + prj/$ bdep sync -p -r libx/1.2.3 \ " |