doc: remove msvc qt build instructions #25851

pull fanquake wants to merge 1 commits into bitcoin:master from fanquake:remove_msvc_qt_build_instructions changing 1 files +2 −16
  1. fanquake commented at 12:58 pm on August 15, 2022: member

    There’s no need for this project to maintain Qt build instructions for Windows. Even less so if they don’t always work, when copy-pasted, and lead to us wasting time trying to debug building qt from source on Windows, i.e #25837.

    Just link to the Qt docs instead.

  2. doc: remove msvc qt build instructions
    There's no need for this project to maintain Qt build instructions for
    Windows. Even less so if they don't always work, when copy-pasted,
    and lead to us wasting time trying to debug building qt from source
    on Windows, i.e #25837.
    
    Just link to the Qt docs instead.
    facfba33e3
  3. fanquake added the label Docs on Aug 15, 2022
  4. fanquake added the label Windows on Aug 15, 2022
  5. jarolrod commented at 1:48 pm on August 15, 2022: member

    ACK facfba33e35ac5cf0990982cb6ccd95d611a7748

    I agree. I verified that the Qt docs include instructions for msvc, didn’t check for their quality but i would assume their better and will stay up to date more than ours could.

    edit: withdraw ACK, per @sipsorcery comment. These instructions can be a starting point and link to more complete documentation. One user who ran into a problem and a maintainer who doesn’t use this and therefore “doesn’t care” about this is no signal to remove it.

  6. MarcoFalke commented at 1:51 pm on August 15, 2022: member
    They are an exact copy of those in the .cirrus.yml file, so they shouldn’t go stale?
  7. fanquake commented at 1:56 pm on August 15, 2022: member

    They are an exact copy of those in the .cirrus.yml file, so they shouldn’t go stale?

    I don’t know. According to #25837 (comment) copy-and-pasting the snippet doesn’t work. I don’t care about this enough to debug, but also don’t want our issue tracker spending time helping people compile Qt from source on Windows.

  8. hebasto commented at 6:08 pm on August 15, 2022: member
  9. sipsorcery commented at 6:24 pm on August 15, 2022: member

    Mild NACK.

    If the msvc build instructions are going to be left in place then even imperfect Qt static build steps are better than nothing. When I first attempted an msvc build of Bitcoin Core the Qt builds took as much tme and effort as all the other projects combined, if not more.

    Maybe instead of removing the instructions a note could be added that building a static version of Qt is difficult and the instructions are intended as a starting point only, along with support issues related to them will be closed.

    If the consensus is to remove them I can go back to maintaining a static binary on https://github.com/sipsorcery/qt_win_binary. Although the binaries and instructions also invariably got out of date or fell behind.

  10. ghost commented at 5:34 am on August 16, 2022: none

    I don’t care about this enough to debug, but also don’t want our issue tracker spending time helping people compile Qt from source on Windows

    NACK if this is the rationale for removing qt build instructions. Maybe instructions could be improved or no changes required as it could help with basic steps.

    Even Android build instructions could be improved but that would be out of scope for this pull request.

  11. in build_msvc/README.md:32 in facfba33e3
    42-nmake install
    43-```
    44-
    45-One could speed up building with [`jom`](https://wiki.qt.io/Jom), a replacement for `nmake` which makes use of all CPU cores.
    46+To build Bitcoin Core with the GUI, building and installing a static version of Qt is required.
    47+You can do so following the Qt build instructions, available [here](https://wiki.qt.io/Building_Qt_5_from_Git).
    


    luke-jr commented at 0:56 am on August 19, 2022:
    Are there instructions somewhere that work with the Qt source code releases?
  12. luke-jr commented at 0:57 am on August 19, 2022: member
    Concept ACK. If the existing guides are not suitable, someone should just post better ones outside this repository and we can link to those.
  13. MarcoFalke added the label Brainstorming on Aug 19, 2022
  14. hebasto commented at 7:53 am on August 30, 2022: member

    There’s no need for this project to maintain Qt build instructions for Windows. Just link to the Qt docs instead.

    https://doc.qt.io/qt-5.15/windows-building.html does not look helpful at all.

    Leaning to NACK.

  15. MarcoFalke commented at 7:54 am on August 30, 2022: member
    Can this be closed?
  16. fanquake commented at 7:55 am on August 30, 2022: member

    https://doc.qt.io/qt-5.15/windows-building.html does not look helpful at all.

    What about it is not helpful? It’s basically a more informative version of our docs.

  17. hebasto commented at 8:04 am on August 30, 2022: member

    https://doc.qt.io/qt-5.15/windows-building.html does not look helpful at all.

    What about it is not helpful? It’s basically a more informative version of our docs.

    Some Qt configuration options are required for our needs. Users need to be provided with Windows version of them.

  18. ghost commented at 12:59 pm on August 30, 2022: none

    https://doc.qt.io/qt-5.15/windows-building.html does not look helpful at all.

    What about it is not helpful? It’s basically a more informative version of our docs.

    Some Qt configuration options are required for our needs. Users need to be provided with Windows version of them.

    Agree

  19. fanquake commented at 8:33 am on August 31, 2022: member
    I still think this could be improved such that we don’t end up with issues like #25837 (or maybe they should just be opened in the GUI repo). In any case, will close this for now.
  20. fanquake closed this on Aug 31, 2022

  21. fanquake deleted the branch on Aug 31, 2022
  22. bitcoin locked this on Aug 31, 2023

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: 2024-12-21 15:12 UTC

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