summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKai Pastor <dg0yt@darc.de>2017-08-25 07:53:09 +0200
committerKai Pastor <dg0yt@darc.de>2018-03-17 10:12:35 +0000
commit78992b83012eb36644a1da4affdede8baac9d2b5 (patch)
treee0613e87b8805fbc97f0f35a4fc49b3265a9d446
parente99e9a0fa1dbaac63426404b1b04f4a9c67dbff7 (diff)
Remove documentation for using CMake < 3.1.0
Support for CMake < 3.1.0 was deprecated in Qt 5.9 and announced to be removed in Qt 5.10. Change-Id: I93358152d0c66bbb157fc561c10c3122edf8a203 Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io> Reviewed-by: Kevin Funk <kevin.funk@kdab.com>
-rw-r--r--doc/src/development/cmake-manual.qdoc58
-rw-r--r--doc/src/snippets/cmake/CMakeLists.pro43
2 files changed, 4 insertions, 97 deletions
diff --git a/doc/src/development/cmake-manual.qdoc b/doc/src/development/cmake-manual.qdoc
index 9c74baa68..b0f856ac2 100644
--- a/doc/src/development/cmake-manual.qdoc
+++ b/doc/src/development/cmake-manual.qdoc
@@ -38,7 +38,7 @@
\c{CMake} is a 3rd party tool with its own \l{CMake Documentation}{documentation}.
The rest of this manual details the specifics of how to use Qt 5 with \c{CMake}.
- The minimum version required to use Qt5 is \c{CMake} 2.8.3, but 3.1.0 is recommended.
+ The minimum version required to use Qt5 is \c{CMake} 3.1.0.
\section1 Getting Started
@@ -46,8 +46,8 @@
and header files shipped with Qt. These libraries and header files can then be used
to build libraries and applications based on Qt.
- The recommended way to use Qt libraries and headers with \c{CMake} 2.8.11 is to use
- the \c{target_link_libraries} command. In \c{CMake} 2.8.11 and later versions, this
+ The recommended way to use Qt libraries and headers with \c{CMake} is to use
+ the \c{target_link_libraries} command. This
command automatically adds appropriate include directories, compile definitions, the
position-independent-code flag, and links to the qtmain.lib library on Windows.
@@ -55,9 +55,6 @@
\snippet snippets/cmake/CMakeLists.pro 0
- Note that setting the minimum required CMake version to 2.8.11 is required for
- automatic linking to the qtmain.lib library on Windows.
-
In order for \c{find_package} to be successful, Qt 5 must be found below the CMAKE_PREFIX_PATH,
or the Qt5<Module>_DIR must be set in the \c{CMake} cache to the location of the
Qt5WidgetsConfig.cmake file. The easiest way to use \c{CMake} is to set the CMAKE_PREFIX_PATH
@@ -98,53 +95,6 @@
\snippet snippets/cmake/CMakeLists.pro 5
- \section2 Using Qt 5 with \c{CMake} older than 3.1.0
-
- Qt 5.7 requires C++11 support. \c{CMake} starting from version 3.1.0 implicitly adds the
- minimum required compiler flags (e.g. \c{-std=gnu++11}) to the Qt5 module targets. If you use
- \c{CMake} version older than 3.1.0, you need to add the needed \c{-std=...} to the targets
- linking against Qt5 modules yourself.
-
- If you use Qt 5.7 and a \c{CMake} version above 3.1.0, plus require a more recent C++ standard
- version, use the CMake way of selecting the standard version, or specify features required and
- let CMake compute the flags. Example:
-
- \snippet snippets/cmake/CMakeLists.pro 6
-
- Also see: \l{https://cmake.org/cmake/help/v3.1/manual/cmake-compile-features.7.html}{CMake cmake-compile-features Documentation}
-
- \section2 Using Qt 5 with \c{CMake} older than 2.8.12
-
- It is also necessary when using an older \c{CMake} to add Qt5<Module>_EXECUTABLE_COMPILE_FLAGS to
- the CMAKE_CXX_FLAGS so that the -fPIC flags are added to the compile flags if necessary (as
- is the default with Qt 5).
-
- \section2 Using Qt 5 with \c{CMake} older than 2.8.11
-
- The recommended way to use Qt libraries and headers with \c{CMake} prior to 2.8.11 is to use
- the \c{qt5_use_modules} macro.
-
- Note that it is necessary to use \c{find_package} to find a Qt module before using the macro.
- See the documentation for the
- \l{CMake find_package Documentation}
- command for the full options it supports.
-
- The \c{qt5_use_modules} macro encapsulates all of the variable usage required to use a Qt module.
- It automatically finds the modules given to it on the command line if they have not already been found.
-
- \snippet snippets/cmake/CMakeLists.pro 3
-
- \section2 Using Qt 5 with \c{CMake} older than 2.8.9
-
- If using \c{CMake} older than 2.8.9, the \c{qt5_use_modules} macro is not available. Attempting to use it
- will result in an error.
-
- To use Qt 5 with versions of \c{CMake} older than 2.8.9, it is necessary to use the
- \c{target_link_libraries}, \c{include_directories}, and \c{add_definitions} commands, and to manually
- specify moc requirements with either \c{qt5_generate_moc} or \c{qt5_wrap_cpp}:
-
- \snippet snippets/cmake/CMakeLists.pro 4
-
\section1 Variable Reference
\section2 Module variables
@@ -159,8 +109,6 @@
\list
\li Qt5Widgets_VERSION String describing the version of the module.
- \li Qt5Widgets_VERSION_STRING Same as Qt5Widgets_VERSION.
- Deprecated, use Qt5Widgets_VERSION instead.
\li Qt5Widgets_LIBRARIES List of libraries for use with the target_link_libraries command.
\li Qt5Widgets_INCLUDE_DIRS List of directories for use with the include_directories command.
\li Qt5Widgets_DEFINITIONS List of definitions for use with add_definitions.
diff --git a/doc/src/snippets/cmake/CMakeLists.pro b/doc/src/snippets/cmake/CMakeLists.pro
index e938ce889..5883924c4 100644
--- a/doc/src/snippets/cmake/CMakeLists.pro
+++ b/doc/src/snippets/cmake/CMakeLists.pro
@@ -1,5 +1,5 @@
#! [0]
-cmake_minimum_required(VERSION 2.8.11)
+cmake_minimum_required(VERSION 3.1.0)
project(testproject)
@@ -34,44 +34,6 @@ set(CMAKE_CXX_FLAGS_COVERAGE "${CMAKE_CXX_FLAGS_RELEASE} -fprofile-arcs -ftest-c
set_target_properties(Qt5::Core PROPERTIES MAP_IMPORTED_CONFIG_COVERAGE "RELEASE")
#! [2]
-#! [3]
-find_package(Qt5Widgets)
-
-add_executable(helloworld WIN32 main.cpp)
-
-qt5_use_modules(helloworld Widgets)
-#! [3]
-
-#! [4]
-cmake_minimum_required(VERSION 2.8.3)
-
-project(testproject)
-
-# Find includes in corresponding build directories
-set(CMAKE_INCLUDE_CURRENT_DIR ON)
-
-# Find the QtWidgets library
-find_package(Qt5Widgets)
-
-# Add the include directories for the Qt 5 Widgets module to
-# the compile lines.
-include_directories(${Qt5Widgets_INCLUDE_DIRS})
-
-# Use the compile definitions defined in the Qt 5 Widgets module
-add_definitions(${Qt5Widgets_DEFINITIONS})
-
-# Add compiler flags for building executables (-fPIE)
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${Qt5Widgets_EXECUTABLE_COMPILE_FLAGS}")
-
-qt5_generate_moc(main.cpp main.moc)
-
-# Tell CMake to create the helloworld executable
-add_executable(helloworld main.cpp main.moc)
-
-#Link the helloworld executable to the Qt 5 widgets library.
-target_link_libraries(helloworld Qt5::Widgets)
-#! [4]
-
#! [5]
foreach(plugin ${Qt5Network_PLUGINS})
get_target_property(_loc ${plugin} LOCATION)
@@ -79,6 +41,3 @@ foreach(plugin ${Qt5Network_PLUGINS})
endforeach()
#! [5]
-#! [6]
-set(CMAKE_CXX_STANDARD 14)
-#! [6]