Update to upstream version '3.10.2'
with Debian dir 01aa2d0bf4
ci/unstable
Felix Geyer
7 years ago
commit
b920e2bbe3
@ -1,39 +0,0 @@
|
|||||||
.gitattributes export-ignore
|
|
||||||
.hooks* export-ignore
|
|
||||||
|
|
||||||
# Custom attribute to mark sources as using our C code style.
|
|
||||||
[attr]our-c-style whitespace=tab-in-indent format.clang-format
|
|
||||||
|
|
||||||
# Custom attribute to mark sources as generated.
|
|
||||||
# Do not perform whitespace checks. Do not format.
|
|
||||||
[attr]generated whitespace=-tab-in-indent,-indent-with-non-tab -format.clang-format
|
|
||||||
|
|
||||||
bootstrap crlf=input
|
|
||||||
configure crlf=input
|
|
||||||
*.[1-9] crlf=input
|
|
||||||
*.sh crlf=input
|
|
||||||
*.sh.in crlf=input
|
|
||||||
|
|
||||||
*.bat -crlf
|
|
||||||
*.bat.in -crlf
|
|
||||||
*.dsp -crlf
|
|
||||||
*.dsw -crlf
|
|
||||||
*.pfx -crlf
|
|
||||||
*.png -crlf
|
|
||||||
*.sln -crlf
|
|
||||||
*.vcproj -crlf
|
|
||||||
|
|
||||||
*.c our-c-style
|
|
||||||
*.cc our-c-style
|
|
||||||
*.cpp our-c-style
|
|
||||||
*.cu our-c-style
|
|
||||||
*.cxx our-c-style
|
|
||||||
*.h our-c-style
|
|
||||||
*.hh our-c-style
|
|
||||||
*.hpp our-c-style
|
|
||||||
*.hxx our-c-style
|
|
||||||
*.notcu our-c-style
|
|
||||||
|
|
||||||
*.cmake whitespace=tab-in-indent
|
|
||||||
*.rst whitespace=tab-in-indent conflict-marker-size=79
|
|
||||||
*.txt whitespace=tab-in-indent
|
|
||||||
@ -1,7 +0,0 @@
|
|||||||
# Exclude MacOS Finder files.
|
|
||||||
.DS_Store
|
|
||||||
|
|
||||||
*.user*
|
|
||||||
|
|
||||||
*.pyc
|
|
||||||
Testing
|
|
||||||
@ -1,10 +0,0 @@
|
|||||||
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
||||||
# file Copyright.txt or https://cmake.org/licensing for details.
|
|
||||||
|
|
||||||
# Loaded by .git/hooks/(pre-commit|commit-msg|prepare-commit-msg)
|
|
||||||
# during git commit after local hooks have been installed.
|
|
||||||
|
|
||||||
[hooks "chain"]
|
|
||||||
pre-commit = Utilities/Git/pre-commit
|
|
||||||
commit-msg = Utilities/Git/commit-msg
|
|
||||||
prepare-commit-msg = Utilities/Git/prepare-commit-msg
|
|
||||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@ -0,0 +1,46 @@
|
|||||||
|
include_guard
|
||||||
|
-------------
|
||||||
|
|
||||||
|
Provides an include guard for the file currently being processed by CMake.
|
||||||
|
|
||||||
|
::
|
||||||
|
|
||||||
|
include_guard([DIRECTORY|GLOBAL])
|
||||||
|
|
||||||
|
Sets up an include guard for the current CMake file (see the
|
||||||
|
:variable:`CMAKE_CURRENT_LIST_FILE` variable documentation).
|
||||||
|
|
||||||
|
CMake will end its processing of the current file at the location of the
|
||||||
|
:command:`include_guard` command if the current file has already been
|
||||||
|
processed for the applicable scope (see below). This provides functionality
|
||||||
|
similar to the include guards commonly used in source headers or to the
|
||||||
|
``#pragma once`` directive. If the current file has been processed previously
|
||||||
|
for the applicable scope, the effect is as though :command:`return` had been
|
||||||
|
called. Do not call this command from inside a function being defined within
|
||||||
|
the current file.
|
||||||
|
|
||||||
|
An optional argument specifying the scope of the guard may be provided.
|
||||||
|
Possible values for the option are:
|
||||||
|
|
||||||
|
``DIRECTORY``
|
||||||
|
The include guard applies within the current directory and below. The file
|
||||||
|
will only be included once within this directory scope, but may be included
|
||||||
|
again by other files outside of this directory (i.e. a parent directory or
|
||||||
|
another directory not pulled in by :command:`add_subdirectory` or
|
||||||
|
:command:`include` from the current file or its children).
|
||||||
|
|
||||||
|
``GLOBAL``
|
||||||
|
The include guard applies globally to the whole build. The current file
|
||||||
|
will only be included once regardless of the scope.
|
||||||
|
|
||||||
|
If no arguments given, ``include_guard`` has the same scope as a variable,
|
||||||
|
meaning that the include guard effect is isolated by the most recent
|
||||||
|
function scope or current directory if no inner function scopes exist.
|
||||||
|
In this case the command behavior is the same as:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
if(__CURRENT_FILE_VAR__)
|
||||||
|
return()
|
||||||
|
endif()
|
||||||
|
set(__CURRENT_FILE_VAR__ TRUE)
|
||||||
@ -0,0 +1,11 @@
|
|||||||
|
ASM<DIALECT>
|
||||||
|
------------
|
||||||
|
|
||||||
|
Preferred executable for compiling a specific dialect of assembly language
|
||||||
|
files. ``ASM<DIALECT>`` can be ``ASM``, ``ASM_NASM``, ``ASM_MASM`` or
|
||||||
|
``ASM-ATT``. Will only be used by CMake on the first configuration to determine
|
||||||
|
``ASM<DIALECT>`` compiler, after which the value for ``ASM<DIALECT>`` is stored
|
||||||
|
in the cache as
|
||||||
|
:variable:`CMAKE_ASM<DIALECT>_COMPILER <CMAKE_<LANG>_COMPILER>`. For subsequent
|
||||||
|
configuration runs, the environment variable will be ignored in favor of
|
||||||
|
:variable:`CMAKE_ASM<DIALECT>_COMPILER <CMAKE_<LANG>_COMPILER>`.
|
||||||
@ -0,0 +1,11 @@
|
|||||||
|
ASM<DIALECT>FLAGS
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling a specific dialect of an
|
||||||
|
assembly language. ``ASM<DIALECT>FLAGS`` can be ``ASMFLAGS``, ``ASM_NASMFLAGS``,
|
||||||
|
``ASM_MASMFLAGS`` or ``ASM-ATTFLAGS``. Will only be used by CMake on the
|
||||||
|
first configuration to determine ``ASM<DIALECT>`` default compilation flags, after
|
||||||
|
which the value for ``ASM<DIALECT>FLAGS`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_ASM<DIALECT>_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_ASM<DIALECT>_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CC
|
||||||
|
--
|
||||||
|
|
||||||
|
Preferred executable for compiling ``C`` language files. Will only be used by
|
||||||
|
CMake on the first configuration to determine ``C`` compiler, after which the
|
||||||
|
value for ``CC`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_C_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration run
|
||||||
|
(including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_C_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CFLAGS
|
||||||
|
------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling ``C`` files. Will only be
|
||||||
|
used by CMake on the first configuration to determine ``CC`` default compilation
|
||||||
|
flags, after which the value for ``CFLAGS`` is stored in the cache
|
||||||
|
as :variable:`CMAKE_C_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration run
|
||||||
|
(including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_C_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
CMAKE_CONFIG_TYPE
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
The default build configuration for :ref:`Build Tool Mode` and
|
||||||
|
``ctest`` build handler when there is no explicit configuration given.
|
||||||
@ -0,0 +1,8 @@
|
|||||||
|
CMAKE_MSVCIDE_RUN_PATH
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
Extra PATH locations for custom commands when using
|
||||||
|
:generator:`Visual Studio 9 2008` (or above) generators.
|
||||||
|
|
||||||
|
The ``CMAKE_MSVCIDE_RUN_PATH`` environment variable sets the default value for
|
||||||
|
the :variable:`CMAKE_MSVCIDE_RUN_PATH` variable if not already explicitly set.
|
||||||
@ -0,0 +1,8 @@
|
|||||||
|
CMAKE_OSX_ARCHITECTURES
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
Target specific architectures for OS X.
|
||||||
|
|
||||||
|
The ``CMAKE_OSX_ARCHITECTURES`` environment variable sets the default value for
|
||||||
|
the :variable:`CMAKE_OSX_ARCHITECTURES` variable. See
|
||||||
|
:prop_tgt:`OSX_ARCHITECTURES` for more information.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CSFLAGS
|
||||||
|
-------
|
||||||
|
|
||||||
|
Preferred executable for compiling ``CSharp`` language files. Will only be
|
||||||
|
used by CMake on the first configuration to determine ``CSharp`` default
|
||||||
|
compilation flags, after which the value for ``CSFLAGS`` is stored in the cache
|
||||||
|
as :variable:`CMAKE_CSharp_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_CSharp_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
CTEST_INTERACTIVE_DEBUG_MODE
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
Environment variable that will exist and be set to ``1`` when a test executed
|
||||||
|
by CTest is run in interactive mode.
|
||||||
@ -0,0 +1,7 @@
|
|||||||
|
CTEST_OUTPUT_ON_FAILURE
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
Boolean environment variable that controls if the output should be logged for
|
||||||
|
failed tests. Set the value to 1, True, or ON to enable output on failure.
|
||||||
|
See :manual:`ctest(1)` for more information on controlling output of failed
|
||||||
|
tests.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
CTEST_PARALLEL_LEVEL
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
Specify the number of tests for CTest to run in parallel. See :manual:`ctest(1)`
|
||||||
|
for more information on parallel test execution.
|
||||||
@ -0,0 +1,4 @@
|
|||||||
|
CTEST_USE_LAUNCHERS_DEFAULT
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
Initializes the :variable:`CTEST_USE_LAUNCHERS` variable if not already defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CUDACXX
|
||||||
|
-------
|
||||||
|
|
||||||
|
Preferred executable for compiling ``CUDA`` language files. Will only be used by
|
||||||
|
CMake on the first configuration to determine ``CUDA`` compiler, after which the
|
||||||
|
value for ``CUDA`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_CUDA_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_CUDA_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CUDAFLAGS
|
||||||
|
---------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling ``CUDA`` files. Will only be
|
||||||
|
used by CMake on the first configuration to determine ``CUDA`` default
|
||||||
|
compilation flags, after which the value for ``CUDAFLAGS`` is stored in the
|
||||||
|
cache as :variable:`CMAKE_CUDA_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if
|
||||||
|
the :variable:`CMAKE_CUDA_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CUDAHOSTCXX
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Preferred executable for compiling host code when compiling ``CUDA``
|
||||||
|
language files. Will only be used by CMake on the first configuration to
|
||||||
|
determine ``CUDA`` host compiler, after which the value for ``CUDAHOSTCXX`` is
|
||||||
|
stored in the cache as :variable:`CMAKE_CUDA_HOST_COMPILER`. For any
|
||||||
|
configuration run (including the first), the environment variable will be
|
||||||
|
ignored if the :variable:`CMAKE_CUDA_HOST_COMPILER` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CXX
|
||||||
|
---
|
||||||
|
|
||||||
|
Preferred executable for compiling ``CXX`` language files. Will only be used by
|
||||||
|
CMake on the first configuration to determine ``CXX`` compiler, after which the
|
||||||
|
value for ``CXX`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_CXX_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_CXX_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
CXXFLAGS
|
||||||
|
--------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling ``CXX`` (C++) files. Will
|
||||||
|
only be used by CMake on the first configuration to determine ``CXX`` default
|
||||||
|
compilation flags, after which the value for ``CXXFLAGS`` is stored in the cache
|
||||||
|
as :variable:`CMAKE_CXX_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration run (
|
||||||
|
including the first), the environment variable will be ignored if
|
||||||
|
the :variable:`CMAKE_CXX_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
DASHBOARD_TEST_FROM_CTEST
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
Environment variable that will exist when a test executed by CTest is run
|
||||||
|
in non-interactive mode. The value will be equal to :variable:`CMAKE_VERSION`.
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
FC
|
||||||
|
--
|
||||||
|
|
||||||
|
Preferred executable for compiling ``Fortran`` language files. Will only be used
|
||||||
|
by CMake on the first configuration to determine ``Fortran`` compiler, after
|
||||||
|
which the value for ``Fortran`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_Fortran_COMPILER <CMAKE_<LANG>_COMPILER>`. For any
|
||||||
|
configuration run (including the first), the environment variable will be
|
||||||
|
ignored if the :variable:`CMAKE_Fortran_COMPILER <CMAKE_<LANG>_COMPILER>`
|
||||||
|
variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
FFLAGS
|
||||||
|
------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling ``Fortran`` files. Will only
|
||||||
|
be used by CMake on the first configuration to determine ``Fortran`` default
|
||||||
|
compilation flags, after which the value for ``FFLAGS`` is stored in the cache
|
||||||
|
as :variable:`CMAKE_Fortran_FLAGS <CMAKE_<LANG>_FLAGS>`. For any configuration
|
||||||
|
run (including the first), the environment variable will be ignored if
|
||||||
|
the :variable:`CMAKE_Fortran_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
LDFLAGS
|
||||||
|
-------
|
||||||
|
|
||||||
|
Will only be used by CMake on the first configuration to determine the default
|
||||||
|
linker flags, after which the value for ``LDFLAGS`` is stored in the cache
|
||||||
|
as :variable:`CMAKE_EXE_LINKER_FLAGS_INIT`,
|
||||||
|
:variable:`CMAKE_SHARED_LINKER_FLAGS_INIT`, and
|
||||||
|
:variable:`CMAKE_MODULE_LINKER_FLAGS_INIT`. For any configuration run
|
||||||
|
(including the first), the environment variable will be ignored if the
|
||||||
|
equivalent ``CMAKE_<TYPE>_LINKER_FLAGS_INIT`` variable is defined.
|
||||||
@ -0,0 +1,8 @@
|
|||||||
|
MACOSX_DEPLOYMENT_TARGET
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
Specify the minimum version of OS X on which the target binaries are
|
||||||
|
to be deployed.
|
||||||
|
|
||||||
|
The ``MACOSX_DEPLOYMENT_TARGET`` environment variable sets the default value for
|
||||||
|
the :variable:`CMAKE_OSX_DEPLOYMENT_TARGET` variable.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
RC
|
||||||
|
--
|
||||||
|
|
||||||
|
Preferred executable for compiling ``resource`` files. Will only be used by CMake
|
||||||
|
on the first configuration to determine ``resource`` compiler, after which the
|
||||||
|
value for ``RC`` is stored in the cache as
|
||||||
|
:variable:`CMAKE_RC_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration run
|
||||||
|
(including the first), the environment variable will be ignored if the
|
||||||
|
:variable:`CMAKE_RC_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
RCFLAGS
|
||||||
|
-------
|
||||||
|
|
||||||
|
Default compilation flags to be used when compiling ``resource`` files. Will
|
||||||
|
only be used by CMake on the first configuration to determine ``resource``
|
||||||
|
default compilation flags, after which the value for ``RCFLAGS`` is stored in
|
||||||
|
the cache as :variable:`CMAKE_RC_FLAGS <CMAKE_<LANG>_FLAGS>`. For any
|
||||||
|
configuration run (including the first), the environment variable will be ignored
|
||||||
|
if the :variable:`CMAKE_RC_FLAGS <CMAKE_<LANG>_FLAGS>` variable is defined.
|
||||||
@ -0,0 +1,54 @@
|
|||||||
|
.. cmake-manual-description: CMake Environment Variables Reference
|
||||||
|
|
||||||
|
cmake-env-variables(7)
|
||||||
|
**********************
|
||||||
|
|
||||||
|
.. only:: html
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
Environment Variables that Control the Build
|
||||||
|
============================================
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 1
|
||||||
|
|
||||||
|
/envvar/CMAKE_CONFIG_TYPE
|
||||||
|
/envvar/CMAKE_MSVCIDE_RUN_PATH
|
||||||
|
/envvar/CMAKE_OSX_ARCHITECTURES
|
||||||
|
/envvar/LDFLAGS
|
||||||
|
/envvar/MACOSX_DEPLOYMENT_TARGET
|
||||||
|
|
||||||
|
Environment Variables for Languages
|
||||||
|
===================================
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 1
|
||||||
|
|
||||||
|
/envvar/ASM_DIALECT
|
||||||
|
/envvar/ASM_DIALECTFLAGS
|
||||||
|
/envvar/CC
|
||||||
|
/envvar/CFLAGS
|
||||||
|
/envvar/CSFLAGS
|
||||||
|
/envvar/CUDACXX
|
||||||
|
/envvar/CUDAFLAGS
|
||||||
|
/envvar/CUDAHOSTCXX
|
||||||
|
/envvar/CXX
|
||||||
|
/envvar/CXXFLAGS
|
||||||
|
/envvar/FC
|
||||||
|
/envvar/FFLAGS
|
||||||
|
/envvar/RC
|
||||||
|
/envvar/RCFLAGS
|
||||||
|
|
||||||
|
Environment Variables for CTest
|
||||||
|
===============================
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 1
|
||||||
|
|
||||||
|
/envvar/CMAKE_CONFIG_TYPE
|
||||||
|
/envvar/CTEST_INTERACTIVE_DEBUG_MODE
|
||||||
|
/envvar/CTEST_OUTPUT_ON_FAILURE
|
||||||
|
/envvar/CTEST_PARALLEL_LEVEL
|
||||||
|
/envvar/CTEST_USE_LAUNCHERS_DEFAULT
|
||||||
|
/envvar/DASHBOARD_TEST_FROM_CTEST
|
||||||
@ -0,0 +1 @@
|
|||||||
|
.. cmake-module:: ../../Modules/CPackFreeBSD.cmake
|
||||||
@ -0,0 +1 @@
|
|||||||
|
.. cmake-module:: ../../Modules/FindOpenACC.cmake
|
||||||
@ -0,0 +1 @@
|
|||||||
|
.. cmake-module:: ../../Modules/FindPatch.cmake
|
||||||
@ -0,0 +1,25 @@
|
|||||||
|
CMP0070
|
||||||
|
-------
|
||||||
|
|
||||||
|
Define :command:`file(GENERATE)` behavior for relative paths.
|
||||||
|
|
||||||
|
CMake 3.10 and newer define that relative paths given to ``INPUT`` and
|
||||||
|
``OUTPUT`` arguments of ``file(GENERATE)`` are interpreted relative to the
|
||||||
|
current source and binary directories, respectively. CMake 3.9 and lower did
|
||||||
|
not define any behavior for relative paths but did not diagnose them either
|
||||||
|
and accidentally treated them relative to the process working directory.
|
||||||
|
Policy ``CMP0070`` provides compatibility with projects that used the old
|
||||||
|
undefined behavior.
|
||||||
|
|
||||||
|
This policy affects behavior of relative paths given to ``file(GENERATE)``.
|
||||||
|
The ``OLD`` behavior for this policy is to treat the paths relative to the
|
||||||
|
working directory of CMake. The ``NEW`` behavior for this policy is to
|
||||||
|
interpret relative paths with respect to the current source or binary
|
||||||
|
directory of the caller.
|
||||||
|
|
||||||
|
This policy was introduced in CMake version 3.10. CMake version
|
||||||
|
|release| warns when the policy is not set and uses ``OLD`` behavior.
|
||||||
|
Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
|
||||||
|
explicitly.
|
||||||
|
|
||||||
|
.. include:: DEPRECATED.txt
|
||||||
@ -0,0 +1,42 @@
|
|||||||
|
CMP0071
|
||||||
|
-------
|
||||||
|
|
||||||
|
Let :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` process
|
||||||
|
:prop_sf:`GENERATED` files.
|
||||||
|
|
||||||
|
Since version 3.10, CMake processes **regular** and :prop_sf:`GENERATED`
|
||||||
|
source files in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
|
||||||
|
In earlier CMake versions, only **regular** source files were processed.
|
||||||
|
:prop_sf:`GENERATED` source files were ignored silently.
|
||||||
|
|
||||||
|
This policy affects how source files that are :prop_sf:`GENERATED`
|
||||||
|
get treated in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
|
||||||
|
|
||||||
|
The ``OLD`` behavior for this policy is to ignore :prop_sf:`GENERATED`
|
||||||
|
source files in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
|
||||||
|
|
||||||
|
The ``NEW`` behavior for this policy is to process :prop_sf:`GENERATED`
|
||||||
|
source files in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` just like regular
|
||||||
|
source files.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
To silence the CMP0071 warning source files can be excluded from
|
||||||
|
:prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` processing by setting the
|
||||||
|
source file properties :prop_sf:`SKIP_AUTOMOC`, :prop_sf:`SKIP_AUTOUIC` or
|
||||||
|
:prop_sf:`SKIP_AUTOGEN`.
|
||||||
|
|
||||||
|
Source skip example::
|
||||||
|
|
||||||
|
# ...
|
||||||
|
set_property(SOURCE /path/to/file1.h PROPERTY SKIP_AUTOMOC ON)
|
||||||
|
set_property(SOURCE /path/to/file2.h PROPERTY SKIP_AUTOUIC ON)
|
||||||
|
set_property(SOURCE /path/to/file3.h PROPERTY SKIP_AUTOGEN ON)
|
||||||
|
# ...
|
||||||
|
|
||||||
|
This policy was introduced in CMake version 3.10. CMake version
|
||||||
|
|release| warns when the policy is not set and uses ``OLD`` behavior.
|
||||||
|
Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
|
||||||
|
explicitly.
|
||||||
|
|
||||||
|
.. include:: DEPRECATED.txt
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
LABELS
|
||||||
|
------
|
||||||
|
|
||||||
|
Specify a list of text labels associated with a directory and all of its
|
||||||
|
subdirectories. This is equivalent to setting the :prop_tgt:`LABELS` target
|
||||||
|
property and the :prop_test:`LABELS` test property on all targets and tests in
|
||||||
|
the current directory and subdirectories. Note: Launchers must enabled to
|
||||||
|
propagate labels to targets.
|
||||||
|
|
||||||
|
The :variable:`CMAKE_DIRECTORY_LABELS` variable can be used to initialize this
|
||||||
|
property.
|
||||||
|
|
||||||
|
The list is reported in dashboard submissions.
|
||||||
@ -1,7 +1,9 @@
|
|||||||
TEST_INCLUDE_FILE
|
TEST_INCLUDE_FILE
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
|
Deprecated. Use :prop_dir:`TEST_INCLUDE_FILES` instead.
|
||||||
|
|
||||||
A cmake file that will be included when ctest is run.
|
A cmake file that will be included when ctest is run.
|
||||||
|
|
||||||
If you specify TEST_INCLUDE_FILE, that file will be included and
|
If you specify ``TEST_INCLUDE_FILE``, that file will be included and
|
||||||
processed when ctest is run on the directory.
|
processed when ctest is run on the directory.
|
||||||
|
|||||||
@ -0,0 +1,7 @@
|
|||||||
|
TEST_INCLUDE_FILES
|
||||||
|
------------------
|
||||||
|
|
||||||
|
A list of cmake files that will be included when ctest is run.
|
||||||
|
|
||||||
|
If you specify ``TEST_INCLUDE_FILES``, those files will be included and
|
||||||
|
processed when ctest is run on the directory.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
VS_SHADER_OUTPUT_HEADER_FILE
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
Set filename for output header file containing object code of a ``.hlsl``
|
||||||
|
source file.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
VS_SHADER_VARIABLE_NAME
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
Set name of variable in header file containing object code of a ``.hlsl``
|
||||||
|
source file.
|
||||||
@ -1,8 +1,13 @@
|
|||||||
PROCESSORS
|
PROCESSORS
|
||||||
----------
|
----------
|
||||||
|
|
||||||
How many process slots this test requires
|
Set to specify how many process slots this test requires.
|
||||||
|
|
||||||
Denotes the number of processors that this test will require. This is
|
Denotes the number of processors that this test will require. This is
|
||||||
typically used for MPI tests, and should be used in conjunction with
|
typically used for MPI tests, and should be used in conjunction with
|
||||||
the ctest_test PARALLEL_LEVEL option.
|
the :command:`ctest_test` ``PARALLEL_LEVEL`` option.
|
||||||
|
|
||||||
|
This will also be used to display a weighted test timing result in label and
|
||||||
|
subproject summaries in the command line output of :manual:`ctest(1)`. The wall
|
||||||
|
clock time for the test run will be multiplied by this property to give a
|
||||||
|
better idea of how much cpu resource CTest allocated for the test.
|
||||||
|
|||||||
@ -0,0 +1,24 @@
|
|||||||
|
AUTOMOC_COMPILER_PREDEFINES
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
Boolean value used by :prop_tgt:`AUTOMOC` to determine if the
|
||||||
|
compiler pre definitions file ``moc_predefs.h`` should be generated.
|
||||||
|
|
||||||
|
CMake generates a ``moc_predefs.h`` file with compiler pre definitions
|
||||||
|
from the output of the command defined in
|
||||||
|
:variable:`CMAKE_CXX_COMPILER_PREDEFINES_COMMAND <CMAKE_<LANG>_COMPILER_PREDEFINES_COMMAND>`
|
||||||
|
when
|
||||||
|
|
||||||
|
- :prop_tgt:`AUTOMOC` is enabled,
|
||||||
|
- :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES` is enabled,
|
||||||
|
- :variable:`CMAKE_CXX_COMPILER_PREDEFINES_COMMAND <CMAKE_<LANG>_COMPILER_PREDEFINES_COMMAND>` isn't empty and
|
||||||
|
- the Qt version is greater or equal 5.8.
|
||||||
|
|
||||||
|
The ``moc_predefs.h`` file, which is generated in :prop_tgt:`AUTOGEN_BUILD_DIR`,
|
||||||
|
is passed to ``moc`` as the argument to the ``--include`` option.
|
||||||
|
|
||||||
|
By default :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES` is initialized from
|
||||||
|
:variable:`CMAKE_AUTOMOC_COMPILER_PREDEFINES`, which is ON by default.
|
||||||
|
|
||||||
|
See the :manual:`cmake-qt(7)` manual for more information on using CMake
|
||||||
|
with Qt.
|
||||||
@ -0,0 +1,32 @@
|
|||||||
|
AUTOMOC_MACRO_NAMES
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
A :ref:`;-list <CMake Language Lists>` list of macro names used by
|
||||||
|
:prop_tgt:`AUTOMOC` to determine if a C++ file needs to be processed by ``moc``.
|
||||||
|
|
||||||
|
This property is only used if the :prop_tgt:`AUTOMOC` property is ``ON``
|
||||||
|
for this target.
|
||||||
|
|
||||||
|
When running :prop_tgt:`AUTOMOC`, CMake searches for the strings listed in
|
||||||
|
:prop_tgt:`AUTOMOC_MACRO_NAMES` in C++ source and header files.
|
||||||
|
If any of the strings is found
|
||||||
|
|
||||||
|
- as the first non space string on a new line or
|
||||||
|
- as the first non space string after a ``{`` on a new line,
|
||||||
|
|
||||||
|
then the file will be processed by ``moc``.
|
||||||
|
|
||||||
|
By default :prop_tgt:`AUTOMOC_MACRO_NAMES` is initialized from
|
||||||
|
:variable:`CMAKE_AUTOMOC_MACRO_NAMES`.
|
||||||
|
|
||||||
|
See the :manual:`cmake-qt(7)` manual for more information on using CMake
|
||||||
|
with Qt.
|
||||||
|
|
||||||
|
Example
|
||||||
|
^^^^^^^
|
||||||
|
|
||||||
|
In this case the the ``Q_OBJECT`` macro is hidden inside an other macro
|
||||||
|
called ``CUSTOM_MACRO``. To let CMake know that source files, that contain
|
||||||
|
``CUSTOM_MACRO``, need to be ``moc`` processed, we call::
|
||||||
|
|
||||||
|
set_property(TARGET tgt APPEND PROPERTY AUTOMOC_MACRO_NAMES "CUSTOM_MACRO")
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
<LANG>_CPPCHECK
|
||||||
|
---------------
|
||||||
|
|
||||||
|
This property is supported only when ``<LANG>`` is ``C`` or ``CXX``.
|
||||||
|
|
||||||
|
Specify a :ref:`;-list <CMake Language Lists>` containing a command line
|
||||||
|
for the ``cppcheck`` static analysis tool. The :ref:`Makefile Generators`
|
||||||
|
and the :generator:`Ninja` generator will run ``cppcheck`` along with the
|
||||||
|
compiler and report any problems.
|
||||||
|
|
||||||
|
This property is initialized by the value of the
|
||||||
|
:variable:`CMAKE_<LANG>_CPPCHECK` variable if it is set when a target is
|
||||||
|
created.
|
||||||
@ -1,11 +1,15 @@
|
|||||||
NO_SYSTEM_FROM_IMPORTED
|
NO_SYSTEM_FROM_IMPORTED
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
Do not treat includes from IMPORTED target interfaces as SYSTEM.
|
Do not treat include directories from the interfaces of consumed
|
||||||
|
:ref:`imported targets` as ``SYSTEM``.
|
||||||
|
|
||||||
The contents of the INTERFACE_INCLUDE_DIRECTORIES of IMPORTED targets
|
The contents of the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` target property
|
||||||
are treated as SYSTEM includes by default. If this property is
|
of imported targets are treated as ``SYSTEM`` includes by default. If this
|
||||||
enabled, the contents of the INTERFACE_INCLUDE_DIRECTORIES of IMPORTED
|
property is enabled on a target, compilation of sources in that target will
|
||||||
targets are not treated as system includes. This property is
|
not treat the contents of the ``INTERFACE_INCLUDE_DIRECTORIES`` of consumed
|
||||||
initialized by the value of the variable CMAKE_NO_SYSTEM_FROM_IMPORTED
|
imported targets as system includes.
|
||||||
if it is set when a target is created.
|
|
||||||
|
This property is initialized by the value of the
|
||||||
|
:variable:`CMAKE_NO_SYSTEM_FROM_IMPORTED` variable if it is set when a target
|
||||||
|
is created.
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue