From 91a98c133041227cebe8e1fc4afb4dfb13a387f2 Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Fri, 5 Jun 2020 13:13:34 +0200 Subject: Doc: Make instructions for adding Qt versions clearer Fixes: QTCREATORBUG-24138 Change-Id: I3cab9c0e4a75cdca7b25be3de24c865fa2f59862 Reviewed-by: Leena Miettinen --- .../creator-only/creator-projects-qt-versions.qdoc | 26 +++++++++++++--------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc index 0c171dc8ce..136fc3bda7 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc @@ -53,16 +53,20 @@ To remove invalid Qt versions, select \uicontrol {Clean Up}. You can link to a Qt that you installed using the Qt Maintenance Tool to - automatically register the installed Qt versions. The mechanism does not - handle Qt versions installed by the system using some other package manager, - such as your Linux distribution, brew on \macos, or Chocolatey on Windows, - nor a self-built Qt. + automatically register the installed Qt versions. However, you cannot link + to Qt versions that were installed by the system using some other package + manager, such as your Linux distribution, brew on \macos, or Chocolatey on + Windows, nor a self-built Qt. In those cases, select \uicontrol {Add} in + the \uicontrol {Qt Versions} tab to add the Qt version manually, as + instructed in \l{Setting Up New Qt Versions}. To link to a Qt installation: \list 1 - \li Select \uicontrol Tools > \uicontrol Options > \uicontrol Kits > - \uicontrol {Qt Versions} > \uicontrol {Link with Qt}. + \li Select \uicontrol Tools > \uicontrol Options > + (or \uicontrol {Qt Creator} > \uicontrol Preferences on + \macos) > \uicontrol Kits > \uicontrol {Qt Versions} > + \uicontrol {Link with Qt}. \image qtcreator-link-with-qt.png "Choose Qt Installation dialog" \li In the \uicontrol {Qt installation path} field, enter the path to the directory where you installed Qt. @@ -72,14 +76,16 @@ \endlist To remove the automatically detected Qt versions from the list, select - \uicontrol {Link with Qt} > \uicontrol {Remove Link}. + \uicontrol {Remove Link}. - If a Qt version is still not listed under \uicontrol Auto-detected, select - \uicontrol {Add} to add it manually. + If a Qt version is still not listed in the \uicontrol {Qt Versions} tab + under \uicontrol Auto-detected, you have to set it up manually, as described + in the following section. You specify the Qt version to use for each \l{glossary-buildandrun-kit} {kit} for building and running your projects - in \uicontrol Tools > \uicontrol Options > \uicontrol Kits. + in \uicontrol Tools > \uicontrol Options > \uicontrol Kits, as described + in \l{Specifying Kit Settings}. \section1 Setting Up New Qt Versions -- cgit v1.2.1