aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorshogerr <shogerr@oregonstate.edu>2019-09-19 16:01:17 -0600
committerPhil Christensen <philc@microsoft.com>2019-09-19 15:01:17 -0700
commit5d90c36ad5885b679ea24ff329e7fd62b6ff9464 (patch)
treeb6998319aba446131d00222af4afd22f3bde4da6 /docs
parent44de09ff5e63ddf20b83b6d9e51638a384957cab (diff)
downloadvcpkg-5d90c36ad5885b679ea24ff329e7fd62b6ff9464.tar.gz
vcpkg-5d90c36ad5885b679ea24ff329e7fd62b6ff9464.zip
Add detailed instructions for custom configurations (#8258)
Resolves #2346
Diffstat (limited to 'docs')
-rw-r--r--docs/about/faq.md5
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/about/faq.md b/docs/about/faq.md
index 504738479..6517774cf 100644
--- a/docs/about/faq.md
+++ b/docs/about/faq.md
@@ -52,11 +52,12 @@ Yes. While Vcpkg will only produce the standard "Release" and "Debug" configurat
First of all, Vcpkg will automatically assume any custom configuration starting with "Release" (resp. "Debug") as a configuration that is compatible with the standard "Release" (resp. "Debug") configuration and will act accordingly.
-For other configurations, you only need to override the MSBuild `$(VcpkgConfiguration)` macro in your project file (.vcxproj) to declare the compatibility between your configuration, and the target standard configuration.
+For other configurations, you only need to override the MSBuild `$(VcpkgConfiguration)` macro in your project file (.vcxproj) to declare the compatibility between your configuration, and the target standard configuration. Unfortunately, due to the sequential nature of MSBuild, you'll need to add those settings much higher in your vcxproj so that it is declared before the Vcpk integration is loaded. It is recommend that the `$(VcpkgConfiguration)` macro is added to the "Globals" PropertyGroup.
For example, you can add support for your "MyRelease" configuration by adding in your project file:
```
-<PropertyGroup>
+<PropertyGroup Label="Globals">
+ ...
<VcpkgConfiguration Condition="'$(Configuration)' == 'MyRelease'">Release</VcpkgConfiguration>
</PropertyGroup>
```