[Cmake-commits] CMake branch, next, updated. v3.0.0-rc6-3615-g5746823

[Stephen Kelly]

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  5746823628117ecee2f7fc03bc49ea8c00743870 (commit)
       via  47c8a884da6a4df03a0b817ddb4ec460f1508659 (commit)
      from  c062294dfd7c293256fea0463cbce5c5e43ab91c (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=5746823628117ecee2f7fc03bc49ea8c00743870
commit 5746823628117ecee2f7fc03bc49ea8c00743870
Merge: c062294 47c8a88
Author:     Stephen Kelly <steveire at gmail.com>
AuthorDate: Fri Jun 6 11:09:29 2014 -0400
Commit:     CMake Topic Stage <kwrobot at kitware.com>
CommitDate: Fri Jun 6 11:09:29 2014 -0400

    Merge topic 'WriteCompilerDetectionHeader-deprecated-define' into next
    
    47c8a884 Add docs.


http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=47c8a884da6a4df03a0b817ddb4ec460f1508659
commit 47c8a884da6a4df03a0b817ddb4ec460f1508659
Author:     Stephen Kelly <steveire at gmail.com>
AuthorDate: Fri Jun 6 17:07:17 2014 +0200
Commit:     Stephen Kelly <steveire at gmail.com>
CommitDate: Fri Jun 6 17:07:17 2014 +0200

    Add docs.

diff --git a/Modules/WriteCompilerDetectionHeader.cmake b/Modules/WriteCompilerDetectionHeader.cmake
index 7b4593b..7db8384 100644
--- a/Modules/WriteCompilerDetectionHeader.cmake
+++ b/Modules/WriteCompilerDetectionHeader.cmake
@@ -133,6 +133,11 @@
 # ``static_assert``, or ignored if using the backward compatibility
 # implementation.
 #
+# The ``cxx_attribute_deprecated`` feature is provides a macro definition
+# ``<PREFIX>_DEPRECATED``, which expands to either the standard
+# ``[[deprecated]] attribute or a compiler-specific attribute symbol such
+# as ``__attribute__`` used by GNU compilers.
+#
 # ============================= ================================ =====================
 #           Feature                          Define                     Symbol
 # ============================= ================================ =====================
@@ -144,7 +149,21 @@
 # ``cxx_attribute_deprecated``   ``<PREFIX>_DEPRECATED``          ``[[deprecated]]``
 # ``cxx_attribute_deprecated``   ``<PREFIX>_DEPRECATED_MSG``      ``[[deprecated]]``
 # ============================= ================================ =====================
-
+#
+# A use-case which arises with such deprecation macros is the deprecation
+# of an entire library.  In that case, all public API in the library may
+# be decorated with the ``<PREFIX>_DEPRECATED`` macro.  This results in
+# very noisy build output when building the library itself, so the macro
+# may be may be defined to empty in that case when building the deprecated
+# library:
+#
+# .. code-block:: cmake
+#
+#   add_library(compat_support ${srcs})
+#   target_compile_definitions(compat_support
+#     PRIVATE
+#       CompatSupport_DEPRECATED=
+#   )
 
 #=============================================================================
 # Copyright 2014 Stephen Kelly <steveire at gmail.com>

-----------------------------------------------------------------------

Summary of changes:
 Modules/WriteCompilerDetectionHeader.cmake |   21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)


hooks/post-receive
-- 
CMake