doc: Update dependency installation for Debian/Ubuntu #31621

pull adlai wants to merge 1 commits into bitcoin:master from adlai:master changing 4 files +4 −4
  1. adlai commented at 2:05 am on January 9, 2025: contributor

    This is similar to the recently-pushed 8d20348 and results in slightly cleaner systems for future Debian/Ubuntu builds.

    According to the description for pkg-config, “pkgconf is a replacement for pkg-config, providing additional functionality while also maintaining compatibility. This package only provides a dependency link to the pkgconf package to help with package upgrades. It can be safely removed.”

    Thus the relevant sections of doc/build-unix.md and depends/README.md are updated.

  2. DrahtBot commented at 2:05 am on January 9, 2025: contributor

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

    Code Coverage & Benchmarks

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

    Reviews

    See the guideline for information on the review process.

    Type Reviewers
    ACK maflcko, fanquake

    If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

    Conflicts

    Reviewers, this pull request conflicts with the following ones:

    • #31349 (ci: detect outbound internet traffic generated while running tests by vasild)
    • #30997 (build: Switch to Qt 6 by hebasto)

    If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

  3. DrahtBot added the label Docs on Jan 9, 2025
  4. adlai force-pushed on Jan 9, 2025
  5. adlai commented at 2:15 am on January 9, 2025: contributor
    Looking over #31334 and #31335 now, it appears that updating CI for Debian should also be done; I’m not familiar with the CI infrastructure, so there’s a good chance one of the regular contributors would get that done much more quickly than I.
  6. adlai force-pushed on Jan 9, 2025
  7. adlai force-pushed on Jan 9, 2025
  8. maflcko commented at 12:01 pm on January 9, 2025: member

    Jammy and Bullseye don’t provide the alias/redirect from pkg-config to pkgconf, but I guess their version of pkgconf should be good enough? Otherwise, it may be better to wait until they are unsupported.

    If this change is made, depends/README.md should be updated as well. Same for ci/test/00_setup_env.sh and .github/workflows/ci.yml.

  9. adlai commented at 12:19 pm on January 9, 2025: contributor

    Jammy and Bullseye don’t provide the alias/redirect from pkg-config to pkgconf, but I guess their version of pkgconf should be good enough? Otherwise, it may be better to wait until they are unsupported.

    The Debian package for pkg-config is still there, and depends on pkgconf… if only it were as lightweight as merely aliasing.

    If this change is made, depends/README.md should be updated as well. Same for ci/test/00_setup_env.sh and .github/workflows/ci.yml.

    Thank you for highlighting the specific locations; I believe one was already fixed in #31335 although I’ve not read the entire conversation there yet; commit fe3457c does touch the CI.yml although it only removes pkg-config without including pkgconf! The blessed Arch Linux coda in docs/build-unix.md doesn’t include either one, either…

  10. adlai force-pushed on Jan 16, 2025
  11. adlai commented at 3:23 pm on January 16, 2025: contributor

    If this change is made, depends/README.md should be updated as well. Same for ci/test/00_setup_env.sh and .github/workflows/ci.yml.

    I have force-pushed to include updates to those two files, along with a few more places; there are still several results to git grep pkg-config: mostly from old release notes, which should probably be left untouched; a few from other distros, where I’ve not tested things; and a few invocations of pkg-config which should work with either version, so I’ve not updated these because it could break systems that have not yet updated.

  12. DrahtBot added the label CI failed on Jan 16, 2025
  13. DrahtBot commented at 3:25 pm on January 16, 2025: contributor

    🚧 At least one of the CI tasks failed. Debug: https://github.com/bitcoin/bitcoin/runs/35722632071

    Try to run the tests locally, according to the documentation. However, a CI failure may still happen due to a number of reasons, for example:

    • Possibly due to a silent merge conflict (the changes in this pull request being incompatible with the current code in the target branch). If so, make sure to rebase on the latest commit of the target branch.

    • A sanitizer issue, which can only be found by compiling with the sanitizer and running the affected test.

    • An intermittent issue.

    Leave a comment here, if you need help tracking down a confusing failure.

  14. maflcko commented at 3:26 pm on January 16, 2025: member

    along with a few more places

    You can’t change the others, as they are fixed subtrees. (See the CI failure).

  15. adlai commented at 3:28 pm on January 16, 2025: contributor

    The automated checks are now reporting two instances of:

    0FAIL: subtree directory was touched without subtree merge
    

    from the places were I fixed a typo in a comment. I’m not familiar with this specific linter setup, and this isn’t supposed to be a merge commit, so could someone please point me towards some documentation or just explain directly why this check fails?

  16. doc: Update dependency installation for Debian/Ubuntu and CI
    According to the description for pkg-config, "pkgconf is a
    replacement for pkg-config, providing additional functionality
    while also maintaining compatibility. This package only provides
    a dependency link to the pkgconf package to help with package
    upgrades. It can be safely removed."
    
    Thus several scripts and markdown files are updated.
    160c27ec07
  17. adlai force-pushed on Jan 16, 2025
  18. adlai commented at 3:32 pm on January 16, 2025: contributor

    along with a few more places

    You can’t change the others, as they are fixed subtrees. (See the CI failure).

    I force-pushed again to remove the modifications to the two Dockerfile scripts.

  19. fanquake referenced this in commit 9dc4eedb67 on Jan 16, 2025
  20. DrahtBot removed the label CI failed on Jan 16, 2025
  21. maflcko commented at 6:21 pm on January 16, 2025: member

    weak ACK 160c27ec078346fbf07f9b84dc10cef2b9809327

    The code changes look fine, and the passing CI seems to indicate that pkgconf works even on Jammy and Bullseye. However, I haven’t spend much time looking into the background here.

  22. fanquake approved
  23. fanquake commented at 11:02 am on January 17, 2025: member
    ACK 160c27ec078346fbf07f9b84dc10cef2b9809327 - seems correct for modern distro versions, and using pkgconf on older ones also seems to work fine.
  24. fanquake merged this on Jan 17, 2025
  25. fanquake closed this on Jan 17, 2025


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: 2025-01-21 03:12 UTC

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