@@ -5,3 +5,25 @@ embedded copy of source code from another package, the upstream source is
55modified to remove the bundled zlib sources. This is accomplished by using the
66--git-prebuild option of git-buildpackage to handle generation of the upstream
77tarball without the embedded code. See debian/gbp.conf for details.
8+
9+ ================================================================================
10+
11+ With the introduction of libmongocrypt to Debian (#968995), the mongo-c-driver
12+ package can now build libmongoc with Client-Side Field Level Encryption support.
13+ However, libmongocrypt requires libbson-dev in order to build. To prevent an
14+ unresolvable Build-Depend cycle, the support for libmongocrypt in the
15+ mongo-c-driver source package can be disabled by building with the
16+ pkg.mongo-c-driver.no-libmongocrypt build profile. Note that when this build
17+ profile is active that only libbson packages are created, as the build profile
18+ concept requires that "a binary package must contain the exact same content for
19+ all profiles with which it builds including no activated profile at all".
20+ (Consult https://wiki.debian.org/BuildProfileSpec for more information on how
21+ build profiles work in Debian.)
22+
23+ When bootstrapping a new architecture or otherwise starting with a situation
24+ where neither the mongo-c-driver nor the libmongocrypt source packages have been
25+ built yet, first use the pkg.mongo-c-driver.no-libmongocrypt build profile to
26+ build the mongo-c-driver source package. Once that is done the libmongocrypt
27+ source package can be built and once the libmongocrypt source package has been
28+ built then the mongo-c-driver source package can be built with no build profile
29+ to produce a complete set of libbson and libmongoc packages.
0 commit comments