This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "CMake".
The branch, next has been updated
via 890d45859885661b59d211b1acf0058c5b44c76d (commit)
via 179f49560286e2e322b9b0cf5d0a277b7634540f (commit)
from 10ea2a5f3ae0e32da81078782174f9393611213c (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=890d45859885661b59d211b1acf0058c5b44c76d
commit 890d45859885661b59d211b1acf0058c5b44c76d
Merge: 10ea2a5 179f495
Author: Brad King <brad.k...@kitware.com>
AuthorDate: Fri Feb 1 10:32:00 2013 -0500
Commit: CMake Topic Stage <kwro...@kitware.com>
CommitDate: Fri Feb 1 10:32:00 2013 -0500
Merge topic 'tll-includes-defines' into next
179f495 find_package: Reword <package>_NO_INTERFACES documentation
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=179f49560286e2e322b9b0cf5d0a277b7634540f
commit 179f49560286e2e322b9b0cf5d0a277b7634540f
Author: Brad King <brad.k...@kitware.com>
AuthorDate: Fri Feb 1 10:30:57 2013 -0500
Commit: Brad King <brad.k...@kitware.com>
CommitDate: Fri Feb 1 10:30:57 2013 -0500
find_package: Reword <package>_NO_INTERFACES documentation
diff --git a/Source/cmFindPackageCommand.cxx b/Source/cmFindPackageCommand.cxx
index e9b6ab6..6e78bd7 100644
--- a/Source/cmFindPackageCommand.cxx
+++ b/Source/cmFindPackageCommand.cxx
@@ -376,26 +376,25 @@ void cmFindPackageCommand::GenerateDocumentation()
"The package configuration file may set <package>_FOUND to false "
"to tell find_package that component requirements are not satisfied."
"\n"
- "Targets exported by the install() command may have additional INTERFACE "
- "properties set for include directories, compile definitions etc. As "
- "these may create a backward compatibility concern for consumers of "
- "existing projects, it is possible to set the <package>_NO_INTERFACES "
- "variable to disable populating those interfaces. It is possible to "
- "emulate a version-based policy for whether the interfaces should be "
- "enabled in the config file before including the imported targets file. "
- "This allows consumers to decide when to enable the new interfaces when "
- "upgrading. The upstream project is responsible for adding code similar "
- "to this in the version which generates the INTERFACE content:\n"
- " if(${CMAKE_FIND_PACKAGE_NAME}_FIND_VERSION VERSION_LESS 2.3\n"
- " AND NOT ${CMAKE_FIND_PACKAGE_NAME}_INTERFACES)\n"
- " set(${CMAKE_FIND_PACKAGE_NAME}_NO_INTERFACES 1)\n"
+ "A package configuration file may include() a <package>Targets.cmake "
+ "file, created by install(EXPORT) in the upstream source, to import "
+ "targets into the downstream consumer. "
+ "When a new version of the upstream adds INTERFACE properties not "
+ "present in a previous version it can change behavior for existing "
+ "downstreams. "
+ "In order to remain source compatible the upstream package configuration "
+ "file may set <package>_NO_INTERFACES to disable INTERFACE properties. "
+ "For example, code of the form:\n"
+ " if(<package>_FIND_VERSION VERSION_LESS <new-version>\n"
+ " AND NOT <package>_INTERFACES)\n"
+ " set(<package>_NO_INTERFACES 1)\n"
" endif()\n"
" include(\"${CMAKE_CURRENT_LIST_DIR}/<package>Targets.cmake\")\n"
- "\n"
- "Downstream users may then choose to use the new interfaces by finding "
- "the newer version of upstream. They can also choose to not use the new "
- "interfaces by setting <package>_INTERFACES to false before finding the "
- "package.\n"
+ "tells <package>Targets.cmake not to provide the INTERFACE properties "
+ "unless the downstream requests at least <new-version> or sets "
+ "<package>_INTERFACES to explicitly request them. "
+ "This allows consumers to decide when to enable the new interfaces when "
+ "upgrading."
"\n"
"See the cmake_policy() command documentation for discussion of the "
"NO_POLICY_SCOPE option."
-----------------------------------------------------------------------
Summary of changes:
Source/cmFindPackageCommand.cxx | 35 +++++++++++++++++------------------
1 files changed, 17 insertions(+), 18 deletions(-)
hooks/post-receive
--
CMake
_______________________________________________
Cmake-commits mailing list
Cmake-commits@cmake.org
http://public.kitware.com/cgi-bin/mailman/listinfo/cmake-commits
