diff options
author | Vojtech Kral <vojtech@kral.hk> | 2019-03-25 17:06:29 +0300 |
---|---|---|
committer | Vojtech Kral <vojtech@kral.hk> | 2019-03-25 17:07:03 +0300 |
commit | aca2ffcdfbefecf00437d89a965d1ccdade567e6 (patch) | |
tree | e7b7dbd679719f3f319e3703bcedbf21c4af4638 /doc | |
parent | 3e0ec8098bce46673c4b0325b85825008ead9d03 (diff) |
doc: Warn about build dir being too nested on Windows
Diffstat (limited to 'doc')
-rw-r--r-- | doc/How to build - Windows.md | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/doc/How to build - Windows.md b/doc/How to build - Windows.md index 627f1c99b..020b28958 100644 --- a/doc/How to build - Windows.md +++ b/doc/How to build - Windows.md @@ -91,6 +91,10 @@ You can also use the Visual Studio GUI or other generators as mentioned above. The `DESTDIR` option is the location where the bundle will be installed. This may be customized. If you leave it empty, the `DESTDIR` will be places inside the same `build` directory. +Warning: If the `build` directory is nested too deep inside other folders, various file paths during the build +become too long and the build might fail due to file writing errors. For this reason, it is recommended to +place the `build` directory relatively close to the drive root. + Note that the build variant that you may choose using Visual Studio (i.e. _Release_ or _Debug_ etc.) when building the dependency package is **not relevant**. The dependency build will by default build _both_ the _Release_ and _Debug_ variants regardless of what you choose in Visual Studio. You can disable building of the debug variant by passing the `-DDEP_DEBUG=OFF` option to CMake, this will only produce a _Release_ build. |