Annotate deprecated items with [[deprecated]].

Author: Nerixyz

include/asio/basic_deadline_timer.hpp

@@ -129,7 +129,7 @@ namespace asio {
 template <typename Time,
     typename TimeTraits = asio::time_traits<Time>,
     typename Executor = any_io_executor>
-class basic_deadline_timer
+class ASIO_DEPRECATED_MSG("Use basic_waitable_timer") basic_deadline_timer
 {
 private:
   class initiate_async_wait;

include/asio/basic_io_object.hpp

@@ -60,7 +60,8 @@ template <typename IoObjectService>
 template <typename IoObjectService,
     bool Movable = detail::service_has_move<IoObjectService>::value>
 #endif
-class basic_io_object
+class ASIO_DEPRECATED_MSG("Deprecated without replacement")
+  basic_io_object
 {
 public:
   /// The type of the service that will be used to provide I/O operations.
@@ -190,7 +191,8 @@ class basic_io_object
 
 // Specialisation for movable objects.
 template <typename IoObjectService>
-class basic_io_object<IoObjectService, true>
+class ASIO_DEPRECATED_MSG("Deprecated without replacement")
+  basic_io_object<IoObjectService, true>
 {
 public:
   typedef IoObjectService service_type;

include/asio/buffer.hpp

@@ -328,7 +328,9 @@ class const_buffer
 /// (Deprecated: Use the socket/descriptor wait() and async_wait() member
 /// functions.) An implementation of both the ConstBufferSequence and
 /// MutableBufferSequence concepts to represent a null buffer sequence.
-class null_buffers
+class ASIO_DEPRECATED_MSG(
+  "Use the socket/descriptor wait() and async_wait() member functions")
+null_buffers
 {
 public:
   /// The type for each element in the list of buffers.

include/asio/deadline_timer.hpp

@@ -31,6 +31,7 @@ namespace asio {
 
 /// (Deprecated: Use system_timer.) Typedef for the typical usage of timer. Uses
 /// a UTC clock.
+ASIO_DEPRECATED_MSG("Use system_timer")
 typedef basic_deadline_timer<boost::posix_time::ptime> deadline_timer;
 
 } // namespace asio

include/asio/detail/config.hpp

@@ -1390,6 +1390,20 @@
 # define ASIO_NODISCARD
 #endif // !defined(ASIO_NODISCARD)
 
+// Compiler support for the the [[deprecated(msg)]] attribute.
+#if !defined(ASIO_DEPRECATED_MSG)
+# if !defined(ASIO_DISABLE_DEPRECATED_MSG)
+#  if defined(__has_cpp_attribute)
+#   if __has_cpp_attribute(deprecated)
+#    define ASIO_DEPRECATED_MSG(msg) [[deprecated(msg)]]
+#   endif // __has_cpp_attribute(deprecated)
+#  endif // defined(__has_cpp_attribute)
+# endif // !defined(ASIO_DISABLE_DEPRECATED_MSG)
+#endif // !defined(ASIO_DEPRECATED_MSG)
+#if !defined(ASIO_DEPRECATED_MSG)
+# define ASIO_DEPRECATED_MSG(msg)
+#endif // !defined(ASIO_DEPRECATED_MSG)
+
 // Kernel support for MSG_NOSIGNAL.
 #if !defined(ASIO_HAS_MSG_NOSIGNAL)
 # if defined(__linux__)

include/asio/detail/push_options.hpp

@@ -62,6 +62,7 @@
 
 # pragma GCC diagnostic push
 # pragma GCC diagnostic ignored "-Wnon-virtual-dtor"
+# pragma GCC diagnostic ignored "-Wdeprecated-declarations"
 # if (__clang_major__ >= 6)
 #  pragma GCC diagnostic ignored "-Wzero-as-null-pointer-constant"
 # endif // (__clang_major__ >= 6)
@@ -106,6 +107,9 @@
 # if (__GNUC__ == 4 && __GNUC_MINOR__ >= 7) || (__GNUC__ > 4)
 #  pragma GCC diagnostic ignored "-Wzero-as-null-pointer-constant"
 # endif // (__GNUC__ == 4 && __GNUC_MINOR__ >= 7) || (__GNUC__ > 4)
+# if (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) || (__GNUC__ > 4)
+#  pragma GCC diagnostic ignored "-Wdeprecated-declarations"
+# endif // (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) || (__GNUC__ > 4)
 # if (__GNUC__ >= 7)
 #  pragma GCC diagnostic ignored "-Wimplicit-fallthrough"
 # endif // (__GNUC__ >= 7)
@@ -184,6 +188,7 @@
 # pragma warning (disable:4512)
 # pragma warning (disable:4610)
 # pragma warning (disable:4675)
+# pragma warning (disable:4996)
 # if (_MSC_VER < 1600)
 // Visual Studio 2008 generates spurious warnings about unused parameters.
 #  pragma warning (disable:4100)

include/asio/impl/execution_context.hpp

@@ -114,6 +114,7 @@ Service& make_service(execution_context& e, Args&&... args)
 }
 
 template <typename Service>
+ASIO_DEPRECATED_MSG("Use make_service()")
 inline void add_service(execution_context& e, Service* svc)
 {
   // Check that Service meets the necessary type requirements.

include/asio/io_context.hpp

@@ -498,6 +498,7 @@ class io_context
    *     boost::bind(f, a1, ... an)); @endcode
    */
   template <typename Handler>
+  ASIO_DEPRECATED_MSG("Use asio::bind_executor()")
 #if defined(GENERATING_DOCUMENTATION)
   unspecified
 #else

include/asio/io_context_strand.hpp

@@ -236,6 +236,7 @@ class io_context::strand
    * @code asio::dispatch(strand, boost::bind(f, a1, ... an)); @endcode
    */
   template <typename Handler>
+  ASIO_DEPRECATED_MSG("Use asio::bind_executor()")
 #if defined(GENERATING_DOCUMENTATION)
   unspecified
 #else

include/asio/time_traits.hpp

@@ -30,11 +30,13 @@ namespace asio {
 
 /// (Deprecated) Time traits suitable for use with the deadline timer.
 template <typename Time>
-struct time_traits;
+struct ASIO_DEPRECATED_MSG("Use basic_waitable_timer and wait_traits")
+  time_traits;
 
 /// (Deprecated) Time traits specialised for posix_time.
 template <>
-struct time_traits<boost::posix_time::ptime>
+struct ASIO_DEPRECATED_MSG("Use basic_waitable_timer and wait_traits")
+  time_traits<boost::posix_time::ptime>
 {
   /// The time type.
   typedef boost::posix_time::ptime time_type;