Tweak Windows CLI docs #692
Conversation
docs/Windows.md
Outdated
| - [Troubleshooting](#troubleshooting) | ||
| - [Multiple definition of `cleanup_glue`, `_reclaim_reent` etc](#multiple-definition-of-cleanup_glue-_reclaim_reent-etc) | ||
|
|
||
| To build using Visual Studio [see here](Windows-VisualStudio.md). The rest of these instructions cover command-line builds. |
There was a problem hiding this comment.
Hmm, I had that after the prerequisites section because the VS docs don't mention installing python/the 32blit tools (and git?).
docs/Windows.md
Outdated
|
|
||
| ### Multiple definition of `cleanup_glue`, `_reclaim_reent` etc | ||
|
|
||
| If you're building *for* 32blit using the ARM GCC toolchain, and it fails with a wall of text full of multiple definition errors, you've probably installed GCC 10. You should use the `gcc-arm-none-eabi-9-2020-q2-update-win32.exe` package. |
There was a problem hiding this comment.
This should be fixed now.
There was a problem hiding this comment.
Yep, using 10.3.1 works fine
docs/Windows.md
Outdated
| "snapOnInput": true, | ||
| "startingDirectory": "%USERPROFILE%" | ||
| } | ||
| ``` |
There was a problem hiding this comment.
Used
{
"commandline": "cmd.exe /k \"C://Program Files (x86)//Microsoft Visual Studio//2022//BuildTools//Common7//Tools//VsDevCmd.bat\"",
"guid": "{5ee0706e-b015-46b2-98a3-2122a8e627d3}",
"name": "Developer Command Prompt for VS2022",
"startingDirectory": "%USERPROFILE%"
}for VS 2022 build tools. (Couldn't find anything to use as an icon and the rest seems optional)
docs/Windows.md
Outdated
| ``` | ||
| py -m pip install 32blit | ||
| pip install 32blit |
There was a problem hiding this comment.
My python install (3.10.2) doesn't seem to have pip (or python) only py.
There was a problem hiding this comment.
This is still true, should drop this change too...
|
|
||
| If you want to run code on 32Blit, you should now refer to [Building & Running On 32Blit](32blit.md). You will need to add `-G"NMake Makefiles"` to your cmake commands and use `nmake` instead of `make`. For example: | ||
| ``` | ||
| mkdir build.stm32 | ||
| cd build.stm32 | ||
| cmake -G"NMake Makefiles" -DCMAKE_TOOLCHAIN_FILE=../32blit.toolchain .. |
There was a problem hiding this comment.
The CMake we get from VS should be new enough for
cmake -B build.stm32 -G"NMake Makefiles" -DCMAKE_TOOLCHAIN_FILE=./32blit.toolchain
instead of this block.
(and then cmake --build build.stm32 [...])
... but I guess If we're doing that we should update other places too...
docs/Windows.md
Outdated
|
|
||
| ### Multiple definition of `cleanup_glue`, `_reclaim_reent` etc | ||
|
|
||
| If you're building *for* 32blit using the ARM GCC toolchain, and it fails with a wall of text full of multiple definition errors, you've probably installed GCC 10. You should use the `gcc-arm-none-eabi-9-2020-q2-update-win32.exe` package. |
There was a problem hiding this comment.
Yep, using 10.3.1 works fine
Daft-Freak
force-pushed
the
patch-windows-cli-docs
branch
from
e9aad48 to
b172f4e
Compare
|
Dropped the windows terminal (developer cmd prompt seems to be there by default now) and arm toolchain troubleshooting (fixed) parts. |
Daft-Freak
force-pushed
the
patch-windows-cli-docs
branch
from
b172f4e to
d338bfd
Compare
We definitely don't use C++/CLI
You still need to read as far as installing the tools
Daft-Freak
force-pushed
the
patch-windows-cli-docs
branch
from
d338bfd to
4b6b6b9
Compare
No description provided.