[Cmake-commits] CMake branch, next, updated. v3.3.0-rc4-1147-g48c5823

[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  48c58230191b648f94d24c2034db140348adee91 (commit)
       via  da18c216d5291ec793d143463a61f48688b52388 (commit)
      from  78cd6ad10cb7c8c2737d5ba934266b7a2a3fa08c (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=48c58230191b648f94d24c2034db140348adee91
commit 48c58230191b648f94d24c2034db140348adee91
Merge: 78cd6ad da18c21
Author:     Stephen Kelly <steveire at gmail.com>
AuthorDate: Sat Jul 18 15:16:51 2015 -0400
Commit:     CMake Topic Stage <kwrobot at kitware.com>
CommitDate: Sat Jul 18 15:16:51 2015 -0400

    Merge topic 'end-Policy-lifetime' into next
    
    da18c216 Help: Document the lifecycle of policies.


http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=da18c216d5291ec793d143463a61f48688b52388
commit da18c216d5291ec793d143463a61f48688b52388
Author:     Stephen Kelly <steveire at gmail.com>
AuthorDate: Sat Jul 18 21:04:14 2015 +0200
Commit:     Stephen Kelly <steveire at gmail.com>
CommitDate: Sat Jul 18 21:16:42 2015 +0200

    Help: Document the lifecycle of policies.

diff --git a/Help/manual/cmake-policies.7.rst b/Help/manual/cmake-policies.7.rst
index 0a313cd..c51ab13 100644
--- a/Help/manual/cmake-policies.7.rst
+++ b/Help/manual/cmake-policies.7.rst
@@ -23,8 +23,39 @@ either ``NEW`` or ``OLD`` behavior explicitly on the command line with the
 A policy is a deprecation mechanism and not a reliable feature toggle.
 A policy should almost never be set to ``OLD``, except to silence warnings
 in an otherwise frozen or stable codebase, or temporarily as part of a
-larger migration path. The ``OLD`` behavior of each policy is undesirable
+larger migration path.  The ``OLD`` behavior of each policy is undesirable
 and will be replaced with an error condition in a future release.
+Maintainers should take timely action to ensure their code works with both
+new and existing versions of CMake without requiring an explicit policy
+setting.  Most policies indicate ways that the code should be changed
+which work with both new and existing CMake releases.
+
+The lifecycle of a policy is:
+
+1. The Policy is introduced in a new version of CMake.  By default the
+   policy issues a warning if code is encountered which depends on ``OLD``
+   behavior.  The warning can be disabled in this release by using
+   the :command:`cmake_policy` command, or by passing ``-Wno-dev`` to
+   the :manual:`cmake(1)` program.
+2. In the release following its introduction, use of
+   the :command:`cmake_policy` command has no effect on whether the
+   warning is issued or not.  Passing ``-Wno-dev`` to
+   the :manual:`cmake(1)` program still silences the warning.
+3. Two releases after the introduction of the policy,
+   passing ``-Wno-dev`` to the :manual:`cmake(1)` program no longer
+   has any effect.
+4. Four releases after the introduction of the policy, the policy may
+   issue an error instead of a warning if ``OLD`` behavior is relied upon.
+   This indicates that the policy has reached the end of its life and the
+   code implementing the ``OLD`` behavior has been removed from the CMake
+   implementation.  Some policies may continue to issue only a warning
+   even four releases after introduction.  This does not mean that it is
+   ok to continue to rely on ``OLD`` behavior.
+
+Note that many existing policies currently have states that appear to not
+follow this lifecycle.  This does not mean that it is ok to continue to
+rely on ``OLD`` behavior for those policies; they will be brought in line
+with this lifecycle in a future release of CMake.
 
 The :command:`cmake_minimum_required` command does more than report an
 error if a too-old version of CMake is used to build a project.  It

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

Summary of changes:


hooks/post-receive
-- 
CMake