@@ -41,11 +41,12 @@ This file is processed by the bin/SConsDoc.py module
41
41
<builder name =" MSVSProject" >
42
42
<summary >
43
43
<para >
44
- Build a C++ project file and solution file.
44
+ Build a &MSVC; project file and solution file.
45
45
</para >
46
46
<para >
47
- Builds a C++ project file based on the
48
- version of Visual Studio (or to be more precise, of MSBuild)
47
+ Builds a &MSVC; project file based on the
48
+ version of Visual Studio (or to be more precise, of
49
+ <application >MSBuild</application >)
49
50
that is configured: either the latest installed version,
50
51
or the version specified by
51
52
&cv-link-MSVC_VERSION; in the current &consenv; .
@@ -57,10 +58,10 @@ This file is processed by the bin/SConsDoc.py module
57
58
Note there are multiple versioning schemes involved in
58
59
the Microsoft compilation environment -
59
60
see the description of &cv-link-MSVC_VERSION; for equivalences.
60
- &SCons; does not know how to construct project files for
61
- other languages (such as <filename >.csproj</filename > for C#,
61
+ Note &SCons; does not know how to construct project files for
62
+ other languages (e.g. <filename >.csproj</filename > for C#,
62
63
<filename >.vbproj</filename > for Visual Basic or
63
- <filename >.pyproject</filename > for Python)) .
64
+ <filename >.pyproject</filename > for Python).
64
65
</para >
65
66
<para >
66
67
For the <filename >.vcxproj</filename > file, the underlying
@@ -69,15 +70,15 @@ This file is processed by the bin/SConsDoc.py module
69
70
https://learn.microsoft.com/en-us/cpp/build/reference/vcxproj-file-structure</ulink >.
70
71
The generated solution file enables Visual Studio to
71
72
understand the project structure, and allows building it
72
- using MSBuild to call back to &SCons; .
73
+ using < application > MSBuild</ application > to call back to &SCons; .
73
74
The project file encodes a toolset version that has been
74
75
selected by &SCons; as described above. Since recent Visual
75
76
Studio versions support multiple concurrent toolsets,
76
77
use &cv-link-MSVC_VERSION; to select the desired one if
77
78
it does not match the &SCons; default.
78
79
The project file also includes entries which describe
79
80
how to call &SCons; to build the project from within Visual Studio
80
- (or from an MSBuild command line).
81
+ (or from an < application > MSBuild</ application > command line).
81
82
In some situations &SCons; may generate this incorrectly -
82
83
notably when using the <emphasis >scons-local</emphasis >
83
84
distribution, which is not installed in a way that that
@@ -112,7 +113,8 @@ This file is processed by the bin/SConsDoc.py module
112
113
(for example if you generate files for inclusion by using the
113
114
&f-link-Glob; function, the results should be converted to
114
115
a list of strings before passing them to &b-MSVSProject; ).
115
- This is because Visual Studio and MSBuild know nothing about &SCons;
116
+ This is because Visual Studio and
117
+ <application >MSBuild</application > know nothing about &SCons;
116
118
Node types.
117
119
Each of the filename lists are individually optional, but at
118
120
least one list must be specified for the resulting project file to
@@ -272,7 +274,8 @@ This file is processed by the bin/SConsDoc.py module
272
274
of the build.
273
275
</para >
274
276
<para >
275
- If the project file is used to drive MSBuild (such as selecting
277
+ If the project file is used to drive
278
+ <application >MSBuild</application > (such as selecting
276
279
"build" from the Visual Studio interface) you lose the direct
277
280
control of target selection and command-line options you would
278
281
have if launching the build directly from &SCons; ,
@@ -283,7 +286,8 @@ This file is processed by the bin/SConsDoc.py module
283
286
targets, arguments, defines, flags and paths for different variants.
284
287
</para >
285
288
<para >
286
- If the build is divided into a solution with multiple MSBuild
289
+ If the build is divided into a solution with multiple
290
+ <application >MSBuild</application >
287
291
projects the mapping is further strained. In this case,
288
292
it is important not to set Visual Studio to do parallel builds,
289
293
as it will then launch the separate project builds in parallel,
@@ -529,7 +533,8 @@ env.MSVSProject(
529
533
into the solution file.
530
534
Note that these filenames need to be specified as strings,
531
535
NOT as &SCons; File Nodes.
532
- This is because the solution file will be interpreted by MSBuild
536
+ This is because the solution file will be interpreted by
537
+ <application >MSBuild</application >
533
538
and by Visual Studio, which know nothing about &SCons; Node types.
534
539
</para >
535
540
</listitem >
@@ -649,7 +654,6 @@ env.MSVSSolution(
649
654
C++ project file as the value of the
650
655
<literal >ProjectGUID</literal > attribute. There is no default
651
656
value. If not defined, a new GUID is generated.
652
-
653
657
</para >
654
658
</summary >
655
659
</cvar > <cvar name =" MSVS_SCC_AUX_PATH" >
@@ -660,7 +664,6 @@ env.MSVSSolution(
660
664
<literal >SccAuxPath</literal > attribute if the
661
665
<envar >MSVS_SCC_PROVIDER</envar > &consvar; is
662
666
also set. There is no default value.
663
-
664
667
</para >
665
668
</summary >
666
669
</cvar > <cvar name =" MSVS_SCC_CONNECTION_ROOT" >
0 commit comments