diff options
Diffstat (limited to 'bpkg/pkg-bindist.cli')
| -rw-r--r-- | bpkg/pkg-bindist.cli | 40 |
1 files changed, 34 insertions, 6 deletions
diff --git a/bpkg/pkg-bindist.cli b/bpkg/pkg-bindist.cli index aa66796..4e03225 100644 --- a/bpkg/pkg-bindist.cli +++ b/bpkg/pkg-bindist.cli @@ -38,7 +38,8 @@ namespace bpkg the binary package is generated for the host architecture using the host's standard system package manager. Additional command line variables (<vars>, normally \cb{config.*}) can be passed to the build system during - the installation step. + the installation step. See distribution-specific description sections + below for details and invocation examples. The specified packages may have dependencies and the default behavior is to not bundle them but rather to specify them as dependencies in the @@ -55,6 +56,32 @@ namespace bpkg // class pkg_bindist_debian_options { + "\h|DEBIAN DESCRIPTION| + + The Debian binary packages are generated by producing the standard + \cb{debian/control}, \cb{debian/rules}, and other package metadata files + and then invoking \cb{dpkg-buildpackage(1)} to build the binary package + from that. In particular, the \cb{debian/rules} implemenation is based on + the \cb{dh(1)} command sequencer. While this approach is normally used to + build packages from source, this implementation \"pretends\" that this is + what's happening by overriding a number of \cb{dh} targets to invoke the + \cb{build2} build system on the required packages directly in their + \cb{bpkg} configuration locations. Typical invocation: + + \ + bpkg build libhello + bpkg test libhello + bpkg bindist -o /tmp/output/ libhello + \ + + Note that the \cb{dpkg-dev} (or \cb{build-essential}) and \cb{debhelper} + Debian packages must be installed before invocation. + + See \l{bpkg#bindist-mapping-debian-produce Debian Package Mapping for + Production} for details on \cb{bpkg} to Debian package name and version + mapping. + " + "\h|PKG-BINDIST DEBIAN OPTIONS|" bool --debian-prepare-only @@ -126,16 +153,17 @@ namespace bpkg string --debian-main-depends { "<v>", - "Override the language runtime dependencies in the \cb{Depends} - \cb{control} file field value of the main binary package." + "Override the language runtime dependencies (such as \cb{libc6}, + \cb{libstdc++6}, etc) in the \cb{Depends} \cb{control} file field + value of the main binary package." } string --debian-dev-depends { "<v>", - "Override the language runtime dependencies in the \cb{Depends} - \cb{control} file field value of the development (\cb{-dev}) binary - package." + "Override the language runtime dependencies (such as \cb{libc-dev}, + \cb{libstdc++-dev}, etc) in the \cb{Depends} \cb{control} file field + value of the development (\cb{-dev}) binary package." } }; |