[obj2yaml] - Fix a comment. NFC.
[llvm-complete.git] / tools / msbuild / LLVM.Cpp.Common.props
blobbc021b3b9e1f87259e0a5d1e2277e1269d3cf210
1 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">\r
2   <!-- The general order of executing an MSBuild file is roughly:\r
3        1) vcxproj file\r
4        2) ├─ Import Microsoft.Cpp.props\r
5        3) │  └─ Import Toolset specific props (e.g. $(VCTargets)Platforms\Win32\PlatformToolsets\llvm\Toolset.props)\r
6        4) │     └─ Import This File (LLVM.Cpp.Common.props)\r
7        5) │─ Core logic of vcxproj (define files, override properties, etc)\r
8        6) └─ Import Microsoft.Cpp.targets\r
9        7)    │─ Import Toolset specific targets file (e.g. $(VCTargets)Platforms\Win32\PlatformToolsets\llvm\Toolset.targets)\r
10        8)    └─ Run the compiler.\r
11        The important thing is that we have hooks at 3, 4, and 7.  3 and 4 give\r
12        us the ability to provide initial values for toolchain settings (where\r
13        is the compiler, what values are considered "default" for a given\r
14        setting, etc), 7 gives us the ability to act on anything that the user\r
15        has overridden (such as warning or erroring on incompatible settings,\r
16        mapping settings to other settings, etc).\r
17        -->\r
19   <PropertyGroup>\r
20     <!-- This initializes the values in Properties > General > Output Directory.\r
21        Builds will fail without this. -->\r
22     <OutDirWasSpecified Condition=" '$(OutDir)'!='' AND '$(OutDirWasSpecified)'=='' ">true</OutDirWasSpecified>\r
23     <OutDirWasSpecified Condition=" '$(OutDir)'=='' AND '$(OutDirWasSpecified)'=='' ">false</OutDirWasSpecified>\r
25     <IntDir Condition="'$(IntDir)'=='' AND '$(IntermediateOutputPath)'!=''">$(IntermediateOutputPath)</IntDir>\r
26     <IntDir Condition="'$(IntDir)'=='' AND '$(IntermediateOutputPath)'==''">$(Configuration)\</IntDir>\r
27     <OutDir Condition="'$(OutDir)'=='' AND '$(SolutionDir)' != ''">$(SolutionDir)$(Configuration)\</OutDir>\r
28     <OutDir Condition="'$(OutDir)'=='' AND '$(SolutionDir)' == ''">$(IntDir)</OutDir>\r
29     <DebuggerFlavor Condition="'$(DebuggerFlavor)'==''">WindowsLocalDebugger</DebuggerFlavor>\r
30   </PropertyGroup>\r
32   <PropertyGroup>\r
33     <!-- Short names for platform toolsets (added to project name in Solution Explorer) -->\r
34     <_PlatformToolsetShortNameFor_llvm>LLVM</_PlatformToolsetShortNameFor_llvm>\r
35     <_PlatformToolsetFriendlyNameFor_llvm>LLVM</_PlatformToolsetFriendlyNameFor_llvm>\r
36   </PropertyGroup>\r
38   <!-- Find an installed LLVM and set up our paths. -->\r
39   <PropertyGroup>\r
40     <LLVMInstallDir>$(Registry:HKEY_LOCAL_MACHINE\SOFTWARE\LLVM\LLVM)</LLVMInstallDir>\r
41     <LLVMInstallDir Condition="'$(LLVMInstallDir)' == ''">$(Registry:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\LLVM\LLVM)</LLVMInstallDir>\r
42     <LLVMInstallDir Condition="'$(LLVMInstallDir)' != ''">$(LLVMInstallDir)\</LLVMInstallDir>\r
43     <ClangClExecutable>$(LLVMInstallDir)bin\clang-cl.exe</ClangClExecutable>\r
44     <LldLinkExecutable>$(LLVMInstallDir)bin\lld-link.exe</LldLinkExecutable>\r
45     <LlvmLibExecutable>$(LLVMInstallDir)bin\llvm-lib.exe</LlvmLibExecutable>\r
46     <UseClangCl>true</UseClangCl>\r
47     <UseLldLink>true</UseLldLink>\r
48     <UseLlvmLib>true</UseLlvmLib>\r
49   </PropertyGroup>\r
51   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.WindowsSDK.props" Condition="Exists('$(VCTargetsPath)\Microsoft.Cpp.WindowsSDK.props')"/>\r
52   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Common.props" />\r
54   <PropertyGroup>\r
55     <!-- Set some paths (such as include paths) that are common to all platforms.  This is the same as what\r
56          the default paths for cl will use.\r
57          -->\r
58     <IncludePath Condition="'$(IncludePath)' == ''">$(IncludePath);$(VC_IncludePath);$(WindowsSDK_IncludePath);</IncludePath>\r
59     <LibraryWPath Condition="'$(LibraryWPath)' == ''">$(WindowsSDK_MetadataPath);</LibraryWPath>\r
60     <SourcePath Condition="'$(SourcePath)' == ''">$(VC_SourcePath);</SourcePath>\r
61   </PropertyGroup>\r
64   <!-- Set values which are reflected in the property UI by default.  The user can override these\r
65        by editing the vcxproj file (or making changes via the UI, which has the same effect).\r
66        -->\r
67   <ItemDefinitionGroup>\r
68     <ClCompile>\r
69       <!-- Set this to "Default" (which means not passing any /RTC option) so that any other value will\r
70            be treated as having been overridden by the user.  This Serves as a hint to the user that\r
71            Default is the value we support, and other values will generate a warning.  It also means\r
72            that if the user simply creates a new project in MSVC (which uses /RTCu by default), then\r
73            switches the toolset to Clang, we will still treat the value as default (which for us is to\r
74            not pass the option).  Only if the user explicitly overrode this setting in a project to use\r
75            /RTCu would we see the warning. -->\r
76       <BasicRuntimeChecks>Default</BasicRuntimeChecks>\r
77     </ClCompile>\r
78   </ItemDefinitionGroup>\r
79 </Project>\r