Skip to content

Conversation

@jarolrod
Copy link
Contributor

@jarolrod jarolrod commented May 27, 2021

The current windows build doc can lead someone to believe that the step where you must choose the posix mingw32 g++ compiler option is only for Ubuntu 18.04. It is only until you (or just me) go through the cross-compile process and realize that it's not building because you didn't set this option on > Ubuntu 18.04. Then you come back and read the footnotes and see: Starting from Ubuntu Xenial 16.04....

This PR improves this portion of the doc by editing the text around this stage to state "this is now the next step". We could add a note saying Ubuntu 18.04 and up, but this is redundant as it's unlikely someone will be using < Ubuntu 18.04 since it's not officially supported by our build system. While here, some minor fixups and add some more guidance to completing this step.

Master: render
PR: render

@dongcarl
Copy link
Contributor

Huh... Perhaps our configure.ac should also search for x86_64-w64-mingw32-g++-posix first before x86_64-w64-mingw32-g++? Just an idea.

@DrahtBot DrahtBot added the Docs label May 27, 2021
@jarolrod jarolrod force-pushed the windows-ubuntu-note branch from 6e745eb to dafab2b Compare May 27, 2021 23:02
@jarolrod
Copy link
Contributor Author

updated from 6e745eb -> dafab2b (pr22088.01 -> pr22088.02, diff)

Changes:

  • Address @hebasto comment.
    • Drop specifying "Ubuntu 18.04 and up" in favor of just saying "This is the next step". This is ok to do as it's unlikely someone will use < Ubuntu 18.04 since it's not officially supported by our build system.

Copy link
Member

@hebasto hebasto left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK dafab2b

Also, it seems reasonable to s/"both the 32 and 64 bit Mingw-w64 packages install"/"Mingw-w64 package installs"/ in the footnote, don't it?

@DrahtBot
Copy link
Contributor

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

Conflicts

Reviewers, this pull request conflicts with the following ones:

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.

@laanwj
Copy link
Member

laanwj commented Jun 2, 2021

Clearly an improvement, agree that it was confusing
ACK dafab2b

@laanwj laanwj merged commit 1186910 into bitcoin:master Jun 2, 2021
sidhujag pushed a commit to syscoin/syscoin that referenced this pull request Jun 3, 2021
dafab2b doc: improve note on choosing posix mingw32 (Jarol Rodriguez)

Pull request description:

  The current [windows build doc](https://github.com/bitcoin/bitcoin/blob/master/doc/build-windows.md) can lead someone to believe that the step where you must choose the posix mingw32 g++ compiler option is only for `Ubuntu 18.04`. It is only until you (or just me) go through the cross-compile process and realize that it's not building because you didn't set this option on > `Ubuntu 18.04`. Then you come back and read the footnotes and see: `Starting from Ubuntu Xenial 16.04...`.

  This PR improves this portion of the doc by editing the text around this stage to state "this is now the next step". We could add a note saying `Ubuntu 18.04 and up`, but this is redundant as it's unlikely someone will be using < Ubuntu 18.04 since it's not officially supported by our build system. While here, some minor fixups and add some more guidance to completing this step.

  **Master:** [render](https://github.com/bitcoin/bitcoin/blob/master/doc/build-windows.md#building-for-64-bit-windows)
  **PR:** [render](https://github.com/bitcoin/bitcoin/blob/dafab2b1b37d1966610b2189e71c52e3af38dfaa/doc/build-windows.md#building-for-64-bit-windows)

ACKs for top commit:
  laanwj:
    ACK dafab2b
  hebasto:
    ACK dafab2b

Tree-SHA512: d8d50fa13c34be753700843183a1a4addad6447c813bfc039865ba11d5fa03c25206ed6f3782331df4c6a44448e3fec4138ae911b995b5cacc5b756bb5d74bb4
gwillen pushed a commit to ElementsProject/elements that referenced this pull request Jun 1, 2022
@bitcoin bitcoin locked as resolved and limited conversation to collaborators Aug 16, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants