[Docs] Update Windows build instructions for using WSL and Ubuntu 17.04 #11437

1. 
   fanquake commented at 11:29 am on October 2, 2017: member

   This updates the Windows build documentation with the workaround required to build using Ubuntu 17.04 on WSL, and makes it’s explicit that building on Ubuntu 16.04 is broken, and not recommended.

   This includes a commit from @donaloconnor in #11244, and is mostly the investigative work of @laanwj throughout #8732, #8653 and quite a few other issues.

   I tested building on 14.04, 16.04.3 and 17.04 here and got the results we expect.

   ---

   Built master at https://github.com/bitcoin/bitcoin/commit/c22a53cd6351b3f0e96de971b001ad712b83fc47 on a Windows 10 VM (Version 1607, OS Build 14393.1593) using WSL with Ubuntu 14.04.

   Upgraded WSL to 16.04.3, and tried building https://github.com/bitcoin/bitcoin/commit/c22a53cd6351b3f0e96de971b001ad712b83fc47 using these instructions. The result is as expected.

   Upgraded WSL to 17.04 and tried building https://github.com/bitcoin/bitcoin/commit/3255d6347b1f9eccbec3d6d93d4a424087a3b35b using these instructions.

   If someone else could also verify that builds are working on both 14.04 and 17.04 with these instructions, that would be great.

2. Add new step to clean $PATH var by removing /mnt specific Window's %PATH% paths that cause issues with the make system 4f890ba6bc
3. fanquake added the label Docs and Output on Oct 2, 2017
4. fanquake added the label Windows on Oct 2, 2017
5. in doc/build-windows.md:68 in a4d42c66b2 outdated

   64@@ -64,6 +65,13 @@ build process.
   65 
   66 See also: [dependencies.md](dependencies.md).
   67 
   68+If your building on Ubuntu 17.04, run these two commands, selecting the 'posix' variant for both,
   

   ---

   ---

   

   meshcollider commented at 11:32 am on October 2, 2017:

   your -> you're
6. 
   meshcollider commented at 11:34 am on October 2, 2017: contributor

   Concept ACK, looks good. Will try and test soon.
7. fanquake force-pushed on Oct 2, 2017
8. 
   laanwj commented at 12:42 pm on October 2, 2017: member

   Thanks for doing this! Hope someone that builds on windows can check this.
9. in doc/build-windows.md:9 in efd88160e3 outdated

    3@@ -4,10 +4,11 @@ WINDOWS BUILD NOTES
    4 Below are some notes on how to build Bitcoin Core for Windows.
    5 
    6 Most developers use cross-compilation from Ubuntu to build executables for
    7-Windows. This is also used to build the release binaries.
    8+Windows. Cross-compilation is also used to build the release binaries.
    9 
   10-Currently only building on Ubuntu Trusty 14.04 is supported.
   11-Other versions are unsupported or known to be broken (e.g. Ubuntu Xenial 16.04).
   12+Currently only building on Ubuntu Trusty 14.04 or Ubuntu Zesty 17.04 is supported.
   

   ---

   ---

   

   MarcoFalke commented at 2:09 pm on October 2, 2017:

   Should say “17.04 and later”
10. in doc/build-windows.md:68 in efd88160e3 outdated

    64@@ -64,6 +65,13 @@ build process.
    65 
    66 See also: [dependencies.md](dependencies.md).
    67 
    68+If you're building on Ubuntu 17.04, run these two commands, selecting the 'posix' variant for both,
    

    ---

    ---

    

    MarcoFalke commented at 2:09 pm on October 2, 2017:

    “17.04 or later”
11. 
    MarcoFalke commented at 2:10 pm on October 2, 2017: member

    Thanks! Tested ACK efd88160e39e5d55905eb6efa0c0f08029ef7a23 on artful.
12. MarcoFalke added the label Needs backport on Oct 2, 2017
13. MarcoFalke added this to the milestone 0.15.1 on Oct 2, 2017
14. [Docs] Update Windows build instructions for using WSL and Ubuntu 17.04 696ce46306
15. fanquake force-pushed on Oct 2, 2017
16. 
    laanwj commented at 10:18 am on October 5, 2017: member

    utACK 696ce46
17. laanwj merged this on Oct 5, 2017
18. laanwj closed this on Oct 5, 2017

    ---

19. laanwj referenced this in commit becbd71b0c on Oct 5, 2017
20. MarcoFalke referenced this in commit dea3b87dd9 on Oct 5, 2017
21. MarcoFalke referenced this in commit c78fecc459 on Oct 5, 2017
22. MarcoFalke removed the label Needs backport on Oct 5, 2017
23. MarcoFalke referenced this in commit c94527a973 on Oct 9, 2017
24. fanquake deleted the branch on Oct 15, 2017
25. laanwj referenced this in commit 7fbf3c638f on Nov 13, 2017
26. codablock referenced this in commit 08513bfffd on Sep 25, 2019
27. barrystyle referenced this in commit 785278ecd1 on Jan 22, 2020
28. DrahtBot locked this on Sep 8, 2021

Contributors
fanquake meshcollider laanwj MarcoFalke

Labels
Docs Windows

Milestone
0.15.2