From cf4161287850fd9d1434bf66869f67251b727459 Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Sat, 24 Jan 2026 18:09:38 +0100 Subject: [PATCH 1/2] Mention that requirements must be installed before building This may be obvious to Python-native developers, but can probably still be helpful for people who just try to follow the instructions. --- README.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 4057dd01..695ae167 100644 --- a/README.rst +++ b/README.rst @@ -228,7 +228,11 @@ Example build command-lines ^^^^^^^^^^^^^^^^^^^^^^^^^^^ To do a complete build from a totally clean git workspace, you will -need to use several of the commands listed above. For example:: +need to install the requirements first with:: + + python -m pip install -r requirements.txt + +and then use several of the commands listed above. For example:: python build.py dox etg --nodoc sip build From 69adb5dc60a47661c8102ed40153203e041a509e Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Sat, 24 Jan 2026 18:12:10 +0100 Subject: [PATCH 2/2] Document that ext/nanosvg is needed even when using system wx The build would fail due to failing to find nanosvg.h when compiling the generated wx/svg/_nanosvg.c otherwise. --- README.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 695ae167..52c1bd0f 100644 --- a/README.rst +++ b/README.rst @@ -120,7 +120,12 @@ details. However be aware that doing so will require a wxWidgets that is unreleased preview snapshots. In other words, the wxWidgets build should use code from the wxWidgets source repository within a few days of when the Phoenix code was checked out. Currently the master branch of Phoenix is -tracking the master branch of wxWidgets. +tracking the master branch of wxWidgets. Also note that even when using an +external copy of wxWidgets with ``--use_syswx`` option, you still need the +contents of ``ext/nanosvg`` submodule for the build to succeed, so you will +still need to run at least:: + + git submodule update --init ext/nanosvg On the other hand, it is probably best to just let wxPython build and bundle wxWidgets. The build tools will by default build wxWidgets in a way that