From 74f55224442b17ef5d6a03783790f1a2fbd22aaa Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Fri, 24 Mar 2023 07:46:38 +0200 Subject: Note relocatable installation in pkg-bindist documentation --- bpkg/pkg-bindist.cli | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/bpkg/pkg-bindist.cli b/bpkg/pkg-bindist.cli index 3f4c847..2c05aaa 100644 --- a/bpkg/pkg-bindist.cli +++ b/bpkg/pkg-bindist.cli @@ -597,6 +597,21 @@ namespace bpkg -C / --strip-components=1 \ + If you expect the binary package to be unpacked into a directory other + than its original installation directory (\cb{--archive-install-root}), + then it's recommended to make it relocatable by specifying the + \cb{config.install.relocatable=true} configuration variable. For example: + + \ + bpkg bindist \ + ... \ + config.install.relocatable=true \ + libhello + \ + + Note that not all source packages support relocatable installation (see + the \l{b#module-install \cb{install}} module documentation for details). + The installation archive package can be generated for a target other than the host by specifying the target triplet with the \cb{--architecture} option. In this case the \cb{bpkg} configuration is assumed to be -- cgit v1.1