[Boost-commit] svn:boost r84850 - in branches/release: . boost boost/signals libs libs/signals libs/signals/doc libs/signals/test

Subject: [Boost-commit] svn:boost r84850 - in branches/release: . boost boost/signals libs libs/signals libs/signals/doc libs/signals/test
From: dnljms_at_[hidden]
Date: 2013-06-20 17:18:17

Author: danieljames
Date: 2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)
New Revision: 84850
URL: http://svn.boost.org/trac/boost/changeset/84850

Log:
Merge signals deprecation.

Still to merge: r78502

Properties modified: 
   branches/release/   (props changed)
   branches/release/boost/   (props changed)
   branches/release/boost/signals/   (props changed)
   branches/release/libs/   (props changed)
   branches/release/libs/libraries.htm   (contents, props changed)
   branches/release/libs/signals/   (props changed)
Text files modified: 
   branches/release/boost/signal.hpp                  |     8 ++++++++                                
   branches/release/libs/libraries.htm                |     6 +++---                                  
   branches/release/libs/signals/doc/faq.xml          |    11 +++++++++++                             
   branches/release/libs/signals/doc/introduction.xml |    15 +++++++++++++--                         
   branches/release/libs/signals/test/Jamfile.v2      |     1 +                                       
   5 files changed, 36 insertions(+), 5 deletions(-)

Modified: branches/release/boost/signal.hpp
==============================================================================
--- branches/release/boost/signal.hpp	Thu Jun 20 17:10:58 2013	(r84849)
+++ branches/release/boost/signal.hpp	2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)	(r84850)
@@ -10,6 +10,14 @@
 #ifndef BOOST_SIGNAL_HPP
 #define BOOST_SIGNAL_HPP
 
+#ifndef BOOST_SIGNALS_NO_DEPRECATION_WARNING
+# if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__DMC__)
+#  pragma message ("Warning: Boost.Signals is no longer being maintained and is now deprecated. Please switch to Boost.Signals2. To disable this warning message, define BOOST_SIGNALS_NO_DEPRECATION_WARNING.")
+# elif defined(__GNUC__) || defined(__HP_aCC) || defined(__SUNPRO_CC) || defined(__IBMCPP__)
+#  warning                  "Boost.Signals is no longer being maintained and is now deprecated. Please switch to Boost.Signals2. To disable this warning message, define BOOST_SIGNALS_NO_DEPRECATION_WARNING."
+# endif
+#endif
+
 #ifndef BOOST_SIGNALS_MAX_ARGS
 #  define BOOST_SIGNALS_MAX_ARGS 10
 #endif

Modified: branches/release/libs/libraries.htm
==============================================================================
--- branches/release/libs/libraries.htm	Thu Jun 20 17:10:58 2013	(r84849)
+++ branches/release/libs/libraries.htm	2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)	(r84850)
@@ -291,7 +291,7 @@
         Execute arbitrary code at scope exit, from Alexander Nasonov and Lorenzo Caminiti.</li>
     <li>serialization
         - Serialization for persistence and marshalling, from Robert Ramey</li>
-    <li>signals - managed signals &amp;
+    <li>signals <em>(deprecated)</em> - managed signals &amp;
          slots callback implementation, from Doug Gregor.</li>
     <li>signals2 - managed signals &amp;
          slots callback implementation (thread-safe version 2), from Frank Mori Hess.</li>
@@ -564,7 +564,7 @@
     passing references to generic functions, from Jaako J&auml;rvi,
     Peter Dimov, Doug Gregor, and Dave Abrahams.</li>
 
-    <li>signals - managed signals &amp;
+    <li>signals <em>(deprecated)</em> - managed signals &amp;
          slots callback implementation, from Doug Gregor.</li>
     <li>signals2 - managed signals &amp;
          slots callback implementation (thread-safe version 2), from Frank Mori Hess.</li>
@@ -771,7 +771,7 @@
     <li>flyweight - Design pattern
     to manage large quantities of highly redundant objects,
     from Joaqu&iacute;n M L&oacute;pez Mu&ntilde;oz.</li>
-    <li>signals - managed signals &amp;
+    <li>signals <em>(deprecated)</em> - managed signals &amp;
          slots callback implementation, from Doug Gregor.</li>
     <li>signals2 - managed signals &amp;
          slots callback implementation (thread-safe version 2), from Frank Mori Hess.</li>

Modified: branches/release/libs/signals/doc/faq.xml
==============================================================================
--- branches/release/libs/signals/doc/faq.xml	Thu Jun 20 17:10:58 2013	(r84849)
+++ branches/release/libs/signals/doc/faq.xml	2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)	(r84850)
@@ -7,6 +7,17 @@
   <qandaset>
     <qandaentry>
       <question>
+        <para>Is Boost.Signals being actively maintained?</para>
+      </question>
+      <answer>
+        <para>No. Please migrate to <ulink url="http://www.boost.org/doc/html/signals2.html">Boost.Signals2</ulink>.
+        There is a 
+        <ulink url="http://www.boost.org/doc/html/signals2/api_changes.html#signals2.porting">porting guide</ulink>
+        in the Signals2 documentation.</para>
+      </answer>
+    </qandaentry>
+    <qandaentry>
+      <question>
         <para>Don't noncopyable signal semantics mean that a class
         with a signal member will be noncopyable as well?</para>
       </question>

Modified: branches/release/libs/signals/doc/introduction.xml
==============================================================================
--- branches/release/libs/signals/doc/introduction.xml	Thu Jun 20 17:10:58 2013	(r84849)
+++ branches/release/libs/signals/doc/introduction.xml	2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)	(r84850)
@@ -2,7 +2,18 @@
 <!DOCTYPE section PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
   "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
 <section last-revision="$Date$">
-  <title>Introduction</title>
+
+<title>Introduction</title>
+
+<note>
+<para><emphasis role="bold">Boost.Signals is no longer being actively maintained.</emphasis>
+Do not use Boost.Signals for new development (use 
+<link linkend="signals2">Boost.Signals2</link>
+instead). If you have existing Boost.Signals-based code, it will
+continue to work, but consider moving to Boost.Signals2. There is
+<link linkend="signals2.porting">
+a porting guide</link> in the Signals2 documentation.</para>
+</note>
 
 <para>The Boost.Signals library is an implementation of a managed
 signals and slots system. Signals represent callbacks with multiple
@@ -25,4 +36,4 @@
 user to specify the manner in which multiple return values are
 combined.</para>
 
-</section>
\ No newline at end of file
+</section>

Modified: branches/release/libs/signals/test/Jamfile.v2
==============================================================================
--- branches/release/libs/signals/test/Jamfile.v2	Thu Jun 20 17:10:58 2013	(r84849)
+++ branches/release/libs/signals/test/Jamfile.v2	2013-06-20 17:18:17 EDT (Thu, 20 Jun 2013)	(r84850)
@@ -16,6 +16,7 @@
         <hardcode-dll-paths>true
         <library>../../test/build//boost_test_exec_monitor
         <library>../build//boost_signals
+        <define>BOOST_SIGNALS_NO_DEPRECATION_WARNING
         <define>BOOST_SIGNALS_STATIC_LINK
         <link>static
     ;