diff --git a/lldb/docs/resources/build.rst b/lldb/docs/resources/build.rst
--- a/lldb/docs/resources/build.rst
+++ b/lldb/docs/resources/build.rst
@@ -92,24 +92,30 @@
* `GnuWin32 `_ for CoreUtils and Make.
* `Python 3 `_. Make sure to (1) get
the x64 variant if that's what you're targetting and (2) install the debug
- library if you want to build a debug lldb.
+ library if you want to build a debug lldb. The standalone installer is the
+ easiest way to get the debug library.
* `Python Tools for Visual Studio
- `_. If you plan to debug test
- failures or even write new tests at all, PTVS is an indispensable debugging
+ `_. If you plan to debug test failures
+ or even write new tests at all, PTVS is an indispensable debugging
extension to VS that enables full editing and debugging support for Python
(including mixed native/managed debugging).
+* `SWIG for Windows _`
The steps outlined here describes how to set up your system and install the
required dependencies such that they can be found when needed during the build
process. They only need to be performed once.
-#. Install Visual Studio with the Windows SDK and ATL components.
+#. Install Visual Studio with the "Desktop Development with C++" workload and
+ the "Python Development" workload.
#. Install GnuWin32, making sure ``\bin`` is added to
your PATH environment variable. Verify that utilities like ``dirname`` and
``make`` are available from your terminal.
#. Install SWIG for Windows, making sure ```` is added to
your PATH environment variable. Verify that ``swig`` is available from your
terminal.
+#. Install Python 3 from the standalone installer and include the debug libraries
+ in the install, making sure the Python install path is added to your PATH
+ environment variable.
#. Register the Debug Interface Access DLLs with the Registry from a privileged
terminal.
@@ -119,9 +125,10 @@
> regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\DIA SDK\bin\amd64\msdia140.dll"
Any command prompt from which you build LLDB should have a valid Visual Studio
-environment setup. This means you should run ``vcvarsall.bat`` or open an
-appropriate Visual Studio Command Prompt corresponding to the version you wish
-to use.
+environment setup. This means you should open an appropriate `Developer Command
+Prompt for VS `_
+corresponding to the version you wish to use or run ``vcvarsall.bat`` or
+``VsDevCmd.bat``.
macOS
*****