diff options
author | Leena Miettinen <riitta-leena.miettinen@qt.io> | 2020-01-23 11:45:07 +0100 |
---|---|---|
committer | Leena Miettinen <riitta-leena.miettinen@qt.io> | 2020-01-27 09:05:07 +0000 |
commit | 5fc456dd2283b2d1e6c4e6d34856052658f34cc4 (patch) | |
tree | 7a7cd26a33014e401536a149fa47f6586b68c247 /doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc | |
parent | c9f90047ac701416e439f492069c1a0bb364fc08 (diff) |
Doc: Rearrange files in the doc folder
Source and configuration files for each manual are now located in a
separate subdirectory, with common configuration files in doc/config.
doc
|_config
|_qtcreator
|_qtcreatordev
|_qtdesignstudio
Edit the config files accordingly.
Change-Id: Idc747a7c16e84f3e06add91234dc5fc908e64cc5
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Diffstat (limited to 'doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc')
-rw-r--r-- | doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc | 121 |
1 files changed, 121 insertions, 0 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 new file mode 100644 index 0000000000..58539f5534 --- /dev/null +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc @@ -0,0 +1,121 @@ +/**************************************************************************** +** +** Copyright (C) 2018 The Qt Company Ltd. +** Contact: https://www.qt.io/licensing/ +** +** This file is part of the Qt Creator documentation. +** +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and The Qt Company. For licensing terms +** and conditions see https://www.qt.io/terms-conditions. For further +** information use the contact form at https://www.qt.io/contact-us. +** +** GNU Free Documentation License Usage +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. Please review the following information to ensure +** the GNU Free Documentation License version 1.3 requirements +** will be met: https://www.gnu.org/licenses/fdl-1.3.html. +** +****************************************************************************/ + +// ********************************************************************** +// NOTE: the sections are not ordered by their logical order to avoid +// reshuffling the file each time the index order changes (i.e., often). +// Run the fixnavi.pl script to adjust the links to the index order. +// ********************************************************************** + +/*! + \contentspage index.html + \previouspage creator-targets.html + \page creator-project-qmake.html + \nextpage creator-tool-chains.html + + \title Adding Qt Versions + + \QC allows you to have multiple versions of Qt installed on your development + PC and use different versions to build your projects. For example, + \l{glossary-device}{device} manufacturers provide special Qt versions for + developing applications for their devices. + + \QC automatically detects the Qt versions that are registered by + your system or by installers. To view detailed information for each Qt + version, select it in the list and select \uicontrol Details in the + \uicontrol {Qt version for} section. To add Qt versions, select + \uicontrol Tools > \uicontrol Options > \uicontrol Kits > + \uicontrol {Qt Versions}. + + 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. + + \section1 Setting Up New Qt Versions + + To add a Qt version: + + \list 1 + + \li Select \uicontrol Tools > \uicontrol Options > \uicontrol Kits > + \uicontrol {Qt Versions} > \uicontrol Add. + + \li Select the qmake executable for the Qt version that you want to + add. + + \li Select the Qt version to view and edit it. + + \image qtcreator-qt4-qtversions-add.png + + \li In the \uicontrol{Version name} field, edit the name that \QC + suggests for the Qt version. + + \li In the \uicontrol{qmake location} field, you can change the qmake + location. + + \li If the Qt version is for QNX, enter the path to your installed QNX SDK in the + \uicontrol{QNX SDK} field. + + \endlist + + \section1 Documentation + + By default, \QC registers only the latest available version of the documentation for each + installed Qt module. + + To register the documentation sets of all installed Qt versions, choose + \uicontrol{All} from the \uicontrol{Register documentation} list. + To register no Qt documentation at all, choose \uicontrol{None}. + The default behavior is \uicontrol{Highest Version Only}. + + \section1 Troubleshooting Qt Installations + + If \QC detects problems in the installation of a Qt version, it displays + warnings and errors beside the name of the Qt version in the list. Select + the Qt version to see more information about the issue and suggestions for + fixing it. + + To determine whether a particular Qt version is installed correctly, \QC + calls \c {qmake -query} and checks that the directories referenced in the + output exist. When \QC complains about the installation of a self-built Qt + version, try running \c {make install} in the build directory to actually + install Qt into the configured location. If you installed Qt using the Qt + installer, run the Qt maintenance tool to check for updates or to reinstall + the Qt version. + + \section1 Minimum Requirements + If your build of Qt is incomplete but you still want to use QMake as build + system, you need to ensure the following minimum requirements to be able to use that setup with \QC. + \list 1 + \li qmake is an executable that understands the -query command line argument. + \li The bin and include directories have to exist. \QC fetches these directories by running \c{qmake -query}. + \li The mkspecs directory should be complete enough to parse .pro files. + \endlist + + If your Qt version has no libQtCore.so, \QC is unable to detect the ABI. + +*/ + + |