[libsigcplusplus/libsigc++-2-10] signal: Deprecate slots().

[Murray Cumming <murrayc src gnome org>]

commit 74fdc49f54d43a011cf7876e526f62c155fa6ec5
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Jul 5 09:22:00 2016 +0200

    signal: Deprecate slots().
    
    Because we don't use it in any tests or examples and probably
    nobody uses it. It has already been removed from libsigc++-3.0
    (which installs in parallel):
    https://git.gnome.org/browse/libsigcplusplus/commit/?id=fb5d1a55ddd843a1ded635b0ebce4e5b5301fc36
    
    Please tell us if you really need to use this.

 sigc++/macros/signal.h.m4 |   19 ++++++++-----------
 1 files changed, 8 insertions(+), 11 deletions(-)
---
diff --git a/sigc++/macros/signal.h.m4 b/sigc++/macros/signal.h.m4
index bffdab9..8f7ed2a 100644
--- a/sigc++/macros/signal.h.m4
+++ b/sigc++/macros/signal.h.m4
@@ -298,11 +298,7 @@ define([SIGNAL_N],[dnl
  * Be careful if you directly pass one signal into the connect()
  * method of another: a shallow copy of the signal is made and
  * the signal's slots are not disconnected until both the signal
- * and its clone are destroyed, which is probably not what you want!
- *
- * An STL-style list interface for the signal's list of slots
- * can be retrieved with slots(). This interface supports
- * iteration, insertion and removal of slots.
+ * and its clone are destroyed, which is probably not what you want.
  *
  * The following template arguments are used:
  * - @e T_return The desired return type for the emit() function (may be overridden by the accumulator).dnl
@@ -402,9 +398,12 @@ _DEPRECATE_IFDEF_END
   bound_const_mem_functor$1<LIST(result_type, signal$1, LOOP(type_trait_take_t<T_arg%1>, $1))> make_slot() 
const
     { return bound_const_mem_functor$1<LIST(result_type, signal$1, LOOP(type_trait_take_t<T_arg%1>, 
$1))>(*this, &signal$1::emit); }
 
+_DEPRECATE_IFDEF_START
   /** Creates an STL-style interface for the signal's list of slots.
    * This interface supports iteration, insertion and removal of slots.
    * @return An STL-style interface for the signal's list of slots.
+   *
+   * @deprecated This is apparently not useful, but please let us know if you need it.
    */
   slot_list_type slots()
     { return slot_list_type(impl()); }
@@ -412,9 +411,12 @@ _DEPRECATE_IFDEF_END
   /** Creates an STL-style interface for the signal's list of slots.
    * This interface supports iteration, insertion and removal of slots.
    * @return An STL-style interface for the signal's list of slots.
+   *
+   * @deprecated This is apparently not useful, but please let us know if you need it.
    */
   const slot_list_type slots() const
     { return slot_list_type(const_cast<signal$1*>(this)->impl()); }
+_DEPRECATE_IFDEF_END
 
   signal$1() {}
 
@@ -454,10 +456,6 @@ ifelse($1, $2,[dnl
  * the signal's slots are not disconnected until both the signal
  * and its clone are destroyed, which is probably not what you want!
  *
- * An STL-style list interface for the signal's list of slots
- * can be retrieved with slots(). This interface supports
- * iteration, insertion and removal of slots.
- *
  * The template arguments determine the function signature of
  * the emit() function:
  * - @e T_return The desired return type of the emit() function.dnl
@@ -847,8 +845,7 @@ struct slot_const_iterator
 /** STL-style list interface for sigc::signal#.
  * slot_list can be used to iterate over the list of slots that
  * is managed by a signal. Slots can be added or removed from
- * the list while existing iterators stay valid. A slot_list
- * object can be retrieved from the signal's slots() function.
+ * the list while existing iterators stay valid.
  *
  * @ingroup signal
  */