doc: Clarify build docs about `pkgconf` / `pkg-config` requirements #35602

pull hebasto wants to merge 1 commits into bitcoin:master from hebasto:260625-pkgconf-docs changing 4 files +13 −11
  1. hebasto commented at 12:43 PM on June 25, 2026: member

    Since #34411, pkgconf/pkg-config is no longer strictly required.

    It is currently required for ZeroMQ on several major distributions and operating systems, including Debian, Ubuntu, the BSD derivatives, and Gentoo.

    Regarding QRencode, our FindQRencode.cmake module treats pkgconf/pkg-config as optional and can successfully locate the package without it.

    This PR amends #34411 and updates the build notes accordingly.

    Addresses #34411#pullrequestreview-4553185425.

  2. doc: Clarify build docs about `pkgconf` / `pkg-config` requirements fb8a103886
  3. hebasto added the label Docs on Jun 25, 2026
  4. DrahtBot commented at 12:43 PM on June 25, 2026: contributor

    <!--e57a25ab6845829454e8d69fc972939a-->

    The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

    <!--006a51241073e994b41acfe9ec718e94-->

    Code Coverage & Benchmarks

    For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/35602.

    <!--021abf342d371248e50ceaed478a90ca-->

    Reviews

    See the guideline for information on the review process.

    Type Reviewers
    ACK purpleKarrot, sedited

    If your review is incorrectly listed, please copy-paste <code>&lt;!--meta-tag:bot-skip--&gt;</code> into the comment that the bot should ignore.

    <!--5faf32d7da4f0f540f40219e4f7537a3-->

  5. fanquake commented at 1:01 PM on June 25, 2026: member

    It is now only needed for ZeroMQ on certain (though mainstream) platforms.

    This could be less vague, it's needed for mainstream distros that we primarily use, like Debian and Ubuntu, as well as at least all the BSDs, and others, like Gentoo and macOS.

    Regarding QRencode, our FindQRencode.cmake module treats pkgconf/pkg-config as optional and can successfully locate the package without it.

    If it works without pkg-config, then we should remove the usage of pkgconfig entirely, rather than say it will work without it, and leave the dependency in the code?

  6. hebasto commented at 1:10 PM on June 25, 2026: member

    It is now only needed for ZeroMQ on certain (though mainstream) platforms.

    This could be less vague, it's needed for mainstream distros that we primarily use, like Debian and Ubuntu, as well as at least all the BSDs, and others, like Gentoo.

    The PR description has been updated.

  7. hebasto commented at 1:22 PM on June 25, 2026: member

    Regarding QRencode, our FindQRencode.cmake module treats pkgconf/pkg-config as optional and can successfully locate the package without it.

    If it works without pkg-config, then we should remove the usage of pkgconfig entirely, rather than say it will work without it, and leave the dependency in the code?

    The current approach is suggested in the official CMake docs:

    First, we try to use pkg-config to find the library. Note that we cannot rely on this, as it may not be available, but it provides a good starting point.

    The same approach is used by CMake in Find Modules they ship. For example, in FindCURL. @purpleKarrot

    What are your thoughts on this?

  8. purpleKarrot commented at 1:40 PM on June 25, 2026: contributor

    The current approach is suggested in the official CMake docs:

    I don't read this as a suggestion, but rather as an example. Relying on pkg-config may be useful when the the library author provides necessary compile flags etc in a .pc file but no .cmake or .cps package. With QRencode, we are really just interested in the include directory and library locations. That is simple enough to do without pkg-config`.

    While cleaning up this module, you may also get rid of SelectLibraryConfigurations. We don't want that QRencode_LIBRARY or QRencode_LIBRARIES is used anywhere; there is no need to set a variable with that name.

  9. hebasto commented at 3:53 PM on June 25, 2026: member

    For the all suggested non-document changes please see #35603.

  10. purpleKarrot commented at 8:22 AM on June 26, 2026: contributor

    ACK fb8a1038867b6e8a938d2c0b66cd961e2fd538d4

  11. sedited approved
  12. sedited commented at 1:47 PM on June 26, 2026: contributor

    ACK fb8a1038867b6e8a938d2c0b66cd961e2fd538d4

  13. fanquake merged this on Jun 26, 2026
  14. fanquake closed this on Jun 26, 2026

  15. hebasto deleted the branch on Jun 26, 2026

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-07-01 06:51 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me