@@ -56,14 +56,13 @@ The options that ``meson-python`` specifies by default are:
56
56
57
57
.. option :: buildtype=release
58
58
59
- The Meson default is to produce a * debug * build with binaries
59
+ The Meson default is to produce a debug build with binaries
60
60
compiled with debug symbols and, when compiling with MSVC, linking
61
61
to the Visual Studio debug runtime, see below. The main purpose of
62
62
``meson-python `` is to build release artifacts, therefore a more
63
- appropriate `build type `__ is selected. A *release * build is
64
- compiled without debug symbols and with compiler
65
- optimizations. Refer to the `Meson documentation `__ for more
66
- details.
63
+ appropriate `build type `__ is selected. A release build is compiled
64
+ without debug symbols and with compiler optimizations. Refer to the
65
+ `Meson documentation `__ for more details.
67
66
68
67
__ https://mesonbuild.com/Builtin-options.html#details-for-buildtype
69
68
__ https://mesonbuild.com/Builtin-options.html#core-options
@@ -74,21 +73,22 @@ __ https://mesonbuild.com/Builtin-options.html#core-options
74
73
disable assertions for release builds. For most users this is a
75
74
surprising and undesired behavior. This option instructs Meson to
76
75
pass the ``-DNDEBUG `` option to the compilers, unless the build
77
- type is set to something else than * release * .
76
+ type is set to something else than release.
78
77
79
78
.. option :: b_vscrt=md
80
79
81
- By default, Meson instructs the MSVC compiler to use the debug
82
- version of the VS runtime library when the build type is set to
83
- *debug *. This causes the linker look for the debug build of all the
84
- linked DLLs. The Python distribution for Windows does not contain a
85
- debug version of the Python DLL and linking fails. The linking
86
- failures are hard to diagnose. To avoid this issue when users
87
- explicitly asks for a debug build, ``meson-python `` sets this
88
- options to instruct Meson to compile with version of the Visual
89
- Studio runtime. For more details, refer to the `Meson
90
- documentation `__ and to the `Visual Studio documentation `__ . This
91
- option is ignored when other compilers are used.
80
+ With the default options, when compiling a debug build, Meson
81
+ instructs the MSVC compiler to use the debug version of the Visual
82
+ Studio runtime library. This causes the MSVC linker to look for the
83
+ debug build of all the linked DLLs. The Python distribution for
84
+ Windows does not contain a debug version of the Python DLL and
85
+ linking fails. These linking failures are surprising and hard to
86
+ diagnose. To avoid this issue when users explicitly asks for a
87
+ debug build, ``meson-python `` sets this options to instruct Meson
88
+ to compile with the release version of the Visual Studio
89
+ runtime. For more details, refer to the `Meson documentation `__ and
90
+ to the `Visual Studio documentation `__ . This option is ignored
91
+ when other compilers are used.
92
92
93
93
__ https://mesonbuild.com/Builtin-options.html#base-options
94
94
__ https://learn.microsoft.com/en-us/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-170
0 commit comments