doc: move `cmake -B build -LH` up in Unix build docs #33088

pull fanquake wants to merge 1 commits into bitcoin:master from fanquake:rebase_32269 changing 1 files +4 −7
  1. fanquake commented at 10:58 AM on July 29, 2025: member

    #32269 rebased.

    I had trouble building bitcoin core the way I wanted since now more features require a flag while building. IMO it makes sense to make it a bit more prominent in the build docs how to get the needed flags.

    Related issue: https://github.com/bitcoin/bitcoin/issues/32258

  2. doc: move `cmake -B build -LH` up in Unix build docs 6757052fc4
  3. DrahtBot added the label Docs on Jul 29, 2025
  4. DrahtBot commented at 10:59 AM on July 29, 2025: 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/33088.

    <!--021abf342d371248e50ceaed478a90ca-->

    Reviews

    See the guideline for information on the review process.

    Type Reviewers
    ACK stickies-v, maflcko, janb84

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

    <!--5faf32d7da4f0f540f40219e4f7537a3-->

  5. stickies-v approved
  6. stickies-v commented at 12:11 PM on July 29, 2025: contributor

    ACK 6757052fc439bedd1fa88ee1d23b4f17cf2c4f7a

    For all other platforms, this configure help lives close to the cmake --build build command, which makes most sense to me. I did note that build-windows.md and build-windows-msvc.md documentation does not provide the cmake -B build -LH help at all. If relevant, could be added in this PR? No blocker.

    Example diff (untested):

    <details> <summary>git diff on 6757052fc4</summary>

    diff --git a/doc/build-windows-msvc.md b/doc/build-windows-msvc.md
    index 2d85d223e9..7c07a19850 100644
    --- a/doc/build-windows-msvc.md
    +++ b/doc/build-windows-msvc.md
    @@ -50,6 +50,8 @@ CMake will put the resulting object files, libraries, and executables into a ded
     
     In the following instructions, the "Debug" configuration can be specified instead of the "Release" one.
     
    +Run `cmake -B build -LH` to see the full list of available options.
    +
     ### 4. Building with Static Linking with GUI
     
     ```
    diff --git a/doc/build-windows.md b/doc/build-windows.md
    index 84db7fa4b5..24c6d06c96 100644
    --- a/doc/build-windows.md
    +++ b/doc/build-windows.md
    @@ -47,9 +47,16 @@ This means you cannot use a directory that is located directly on the host Windo
     
     Build using:
     
    +```bash
         gmake -C depends HOST=x86_64-w64-mingw32  # Append "-j N" for N parallel jobs.
         cmake -B build --toolchain depends/x86_64-w64-mingw32/toolchain.cmake
    +```
    +
    +Run `cmake -B build -LH` to see the full list of available options.
    +
    +```bash
         cmake --build build     # Append "-j N" for N parallel jobs.
    +```
     
     ## Depends system
     
    
    

    </details>

  7. maflcko commented at 12:53 PM on July 29, 2025: member

    lgtm ACK 6757052fc439bedd1fa88ee1d23b4f17cf2c4f7a

  8. janb84 commented at 1:55 PM on July 29, 2025: contributor

    ACK 6757052fc439bedd1fa88ee1d23b4f17cf2c4f7a

    This PR moves information on getting all the available options of cmake -B build to a more prominent place, line 13. The PR seems to me a logical change and makes me wonder why this information was at the end of the documentation in the first place.

  9. fanquake commented at 3:15 PM on July 29, 2025: member

    @stickies-v might follow up with any Windows doc changes.

  10. fanquake merged this on Jul 29, 2025
  11. fanquake closed this on Jul 29, 2025

  12. fanquake deleted the branch on Jul 29, 2025
  13. luke-jr commented at 6:47 AM on July 31, 2025: member

    (might make sense to mention ccmake too?)

  14. fanquake referenced this in commit a08886d564 on Aug 3, 2025
  15. alexanderwiederin referenced this in commit 28fe919bf7 on Aug 6, 2025
  16. sedited referenced this in commit b98d982d79 on Aug 7, 2025
  17. alexanderwiederin referenced this in commit 4152176d02 on Aug 8, 2025
  18. alexanderwiederin referenced this in commit 9ef94c31db on Aug 8, 2025
  19. fanquake referenced this in commit 837c5c7fd8 on Aug 15, 2025
  20. stringintech referenced this in commit 71275a1b5e on Aug 17, 2025
  21. yuvicc referenced this in commit 22f55cf11d on Aug 26, 2025
  22. ajtowns referenced this in commit f9a105466d on Sep 4, 2025
  23. bug-castercv502 referenced this in commit 4aa5572aea on Sep 28, 2025
  24. stickies-v referenced this in commit a19c56cd7c on Nov 4, 2025
  25. fanquake referenced this in commit 0b45e6db10 on Nov 7, 2025
  26. morozow referenced this in commit 7b7b46ae36 on May 8, 2026
  27. morozow referenced this in commit 149ac9db50 on May 8, 2026
  28. Kino1994 referenced this in commit 10dd33610b on Jun 28, 2026
  29. BigcoinBGC referenced this in commit c7992c9699 on Jun 30, 2026
  30. bitcoin locked this on Jul 31, 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-08-10 22:51 UTC

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