From 217b6eae033d178ed33a2cbcdfbb0671d46545ee Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Mon, 26 Feb 2024 13:53:56 +0100 Subject: [PATCH] Doc: Describe using junction points on Windows Task-number: QTCREATORBUG-30209 Change-Id: If6692b697e92a6d3fdffaaddc268cab82f50afd4 Reviewed-by: Cristian Adam --- .../qtcreator-preferences-cmake-general.webp | Bin 3406 -> 3816 bytes .../creator-projects-cmake-building.qdoc | 20 ++++++++++++++++++ 2 files changed, 20 insertions(+) diff --git a/doc/qtcreator/images/qtcreator-preferences-cmake-general.webp b/doc/qtcreator/images/qtcreator-preferences-cmake-general.webp index e6b7de61f33ee971d1ec0503cf0d4c5e2c7c0e52..fb3b61eff00ef6d03092812d35e71c973b37cddc 100644 GIT binary patch literal 3816 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 SYrgOQ%`fZC{`O~gvj705;9M5~ literal 3406 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 diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc index c8da5117fb6..6f5508312f5 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc @@ -200,6 +200,26 @@ \image qtcreator-build-configuration-set-clicolor-force.webp {Build Environment with CLICOLOR_FORCE set} + \section1 Using Junction Points on Windows + + To overcome issues with long paths on Windows, create and use + \l{https://learn.microsoft.com/en-us/sysinternals/downloads/junction} + {junction points} for the source and build directories. At a junction point, + a directory serves as an alias to another directory on the computer. + + To use the junction points for CMake configure, build, and install + operations, go to \preferences > \uicontrol CMake > \uicontrol General and + select \uicontrol {Use junctions for CMake configuration and build operations}. + + \image qtcreator-preferences-cmake-general.webp {CMake General preferences} + + \QC stores junction points in \c {C:\ProgramData\QtCreator\Links}. To use + another path, set it as the value of the \c QTC_CMAKE_JUNCTIONS_DIR + environment variable. + + Set the \c QTC_CMAKE_JUNCTIONS_HASH_LENGTH environment variable to shorten + the MD5 hash key length from the default length value of 32. + \section1 CMake Build Steps \QC builds CMake projects by running \c {cmake . --build}, which then runs