couchbase 4.2.0 → 4.2.2

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/reference.xsl

@@ -2,7 +2,7 @@
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
 
 <!--
-  Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+  Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
 
   Distributed under the Boost Software License, Version 1.0. (See accompanying
   file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -30,7 +30,7 @@
 -->
 <xsl:template match="/doxygen">
 <xsl:text>[/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -46,17 +46,19 @@
 [include requirements/asynchronous_socket_operations.qbk]
 [include requirements/AcceptableProtocol.qbk]
 [include requirements/AcceptHandler.qbk]
+[include requirements/AcceptToken.qbk]
 [include requirements/AsyncRandomAccessReadDevice.qbk]
 [include requirements/AsyncRandomAccessWriteDevice.qbk]
 [include requirements/AsyncReadStream.qbk]
 [include requirements/AsyncWriteStream.qbk]
 [include requirements/BufferedHandshakeHandler.qbk]
+[include requirements/BufferedHandshakeToken.qbk]
 [include requirements/CancellationHandler.qbk]
 [include requirements/CancellationSlot.qbk]
 [include requirements/CompletionCondition.qbk]
-[include requirements/CompletionHandler.qbk]
 [include requirements/ConnectCondition.qbk]
 [include requirements/ConnectHandler.qbk]
+[include requirements/ConnectToken.qbk]
 [include requirements/ConstBufferSequence.qbk]
 [include requirements/DynamicBuffer.qbk]
 [include requirements/DynamicBuffer_v1.qbk]
@@ -69,35 +71,46 @@
 [include requirements/GettableSocketOption.qbk]
 [include requirements/Handler.qbk]
 [include requirements/HandshakeHandler.qbk]
+[include requirements/HandshakeToken.qbk]
 [include requirements/InternetProtocol.qbk]
 [include requirements/IoControlCommand.qbk]
 [include requirements/IoObjectService.qbk]
 [include requirements/IteratorConnectHandler.qbk]
+[include requirements/IteratorConnectToken.qbk]
 [include requirements/LegacyCompletionHandler.qbk]
 [include requirements/MoveAcceptHandler.qbk]
+[include requirements/MoveAcceptToken.qbk]
 [include requirements/MutableBufferSequence.qbk]
+[include requirements/NullaryToken.qbk]
 [include requirements/OperationState.qbk]
 [include requirements/ProtoAllocator.qbk]
 [include requirements/Protocol.qbk]
 [include requirements/RangeConnectHandler.qbk]
+[include requirements/RangeConnectToken.qbk]
 [include requirements/ReadHandler.qbk]
+[include requirements/ReadToken.qbk]
 [include requirements/Receiver.qbk]
 [include requirements/ResolveHandler.qbk]
+[include requirements/ResolveToken.qbk]
 [include requirements/Scheduler.qbk]
 [include requirements/Sender.qbk]
 [include requirements/Service.qbk]
 [include requirements/SettableSerialPortOption.qbk]
 [include requirements/SettableSocketOption.qbk]
 [include requirements/ShutdownHandler.qbk]
+[include requirements/ShutdownToken.qbk]
 [include requirements/SignalHandler.qbk]
+[include requirements/SignalToken.qbk]
 [include requirements/SyncRandomAccessReadDevice.qbk]
 [include requirements/SyncRandomAccessWriteDevice.qbk]
 [include requirements/SyncReadStream.qbk]
 [include requirements/SyncWriteStream.qbk]
 [include requirements/TimeTraits.qbk]
 [include requirements/WaitHandler.qbk]
+[include requirements/WaitToken.qbk]
 [include requirements/WaitTraits.qbk]
 [include requirements/WriteHandler.qbk]
+[include requirements/WriteToken.qbk]
 
 </xsl:text>
 
@@ -694,6 +707,16 @@
       <xsl:value-of name="text" select="$ref-name"/>
       <xsl:text>`]</xsl:text>
     </xsl:when>
+    <xsl:when test="@refid = 'asynchronous_operation'">
+      <xsl:text>[link asio.overview.model.async_ops </xsl:text>
+      <xsl:value-of select="."/>
+      <xsl:text>]</xsl:text>
+    </xsl:when>
+    <xsl:when test="@refid = 'completion_token'">
+      <xsl:text>[link asio.overview.model.completion_tokens </xsl:text>
+      <xsl:value-of select="."/>
+      <xsl:text>]</xsl:text>
+    </xsl:when>
     <xsl:otherwise>
       <xsl:text>`</xsl:text>
       <xsl:value-of select="."/>
@@ -727,6 +750,16 @@
       <xsl:value-of name="text" select="$ref-name"/>
       <xsl:text>`]</xsl:text>
     </xsl:when>
+    <xsl:when test="@refid = 'asynchronous_operation'">
+      <xsl:text>[link asio.overview.model.async_ops </xsl:text>
+      <xsl:value-of select="."/>
+      <xsl:text>]</xsl:text>
+    </xsl:when>
+    <xsl:when test="@refid = 'completion_token'">
+      <xsl:text>[link asio.overview.model.completion_tokens </xsl:text>
+      <xsl:value-of select="."/>
+      <xsl:text>]</xsl:text>
+    </xsl:when>
     <xsl:otherwise>
       <xsl:text>`</xsl:text>
       <xsl:value-of select="."/>
@@ -1577,6 +1610,9 @@
 <xsl:text>
       </xsl:text><xsl:value-of select="type"/><xsl:text> </xsl:text>
       <xsl:choose>
+        <xsl:when test="declname = 'A'">
+          <xsl:value-of select="declname"/>
+        </xsl:when>
         <xsl:when test="declname = 'Allocator'">
           <xsl:value-of select="declname"/>
         </xsl:when>
@@ -1613,6 +1649,9 @@
         <xsl:when test="declname = 'Clock'">
           <xsl:value-of select="declname"/>
         </xsl:when>
+        <xsl:when test="declname = 'CompletionHandler'">
+          <xsl:value-of select="declname"/>
+        </xsl:when>
         <xsl:when test="declname = 'CompletionToken'">
           <xsl:value-of select="declname"/>
         </xsl:when>
@@ -1676,6 +1715,9 @@
         <xsl:when test="declname = 'Head'">
           <xsl:value-of select="declname"/>
         </xsl:when>
+        <xsl:when test="declname = 'I'">
+          <xsl:value-of select="declname"/>
+        </xsl:when>
         <xsl:when test="declname = 'IoObjectService1'">
           <xsl:value-of select="concat('``[link asio.reference.IoObjectService ', declname, ']``')"/>
         </xsl:when>
@@ -1817,6 +1859,9 @@
         <xsl:when test="declname = 'SocketService1' or declname = 'SocketService2'">
           <xsl:value-of select="concat('``[link asio.reference.SocketService ', declname, ']``')"/>
         </xsl:when>
+        <xsl:when test="declname = 'StackAllocator'">
+          <xsl:value-of select="declname"/>
+        </xsl:when>
         <xsl:when test="declname = 'Stream'">
           <xsl:value-of select="declname"/>
         </xsl:when>
@@ -1957,7 +2002,8 @@
 <xsl:value-of select="$id"/>
 <xsl:text>..</xsl:text>
 <xsl:value-of select="$name"/>
-<xsl:text>] </xsl:text>
+<xsl:text>]</xsl:text>
+<xsl:value-of select="$newline"/>
 
 <xsl:for-each select="($all-compounddefs)[@kind='group' and compoundname=$name]">
   <xsl:apply-templates select="briefdescription" mode="markup"/>
@@ -2008,7 +2054,8 @@
   <xsl:value-of select="$id"/>
   <xsl:text>..</xsl:text>
   <xsl:value-of select="$name"/>
-  <xsl:text>] </xsl:text>
+  <xsl:text>]</xsl:text>
+  <xsl:value-of select="$newline"/>
 </xsl:if>
 
 <xsl:apply-templates select="briefdescription" mode="markup"/><xsl:text>

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AcceptHandler.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -12,61 +12,4 @@ asio.reference.Handler handler]. A value `h` of an accept handler
 class should work correctly in the expression `h(ec)`, where `ec` is an lvalue
 of type `const error_code`.
 
-[heading Examples]
-
-A free function as an accept handler:
-
-  void accept_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-
-An accept handler function object:
-
-  struct accept_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as an accept handler:
-
-  acceptor.async_accept(...,
-      [](const asio::error_code& ec)
-      {
-        ...
-      });
-
-A non-static class member function adapted to an accept handler using
-`std::bind()`:
-
-  void my_class::accept_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  acceptor.async_accept(...,
-      std::bind(&my_class::accept_handler,
-        this, std::placeholders::_1));
-
-A non-static class member function adapted to an accept handler using
-`boost::bind()`:
-
-  void my_class::accept_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  acceptor.async_accept(...,
-      boost::bind(&my_class::accept_handler,
-        this, asio::placeholders::error));
-
 [endsect]

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AcceptToken.qbk

@@ -0,0 +1,99 @@
+[/
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ /
+ / Distributed under the Boost Software License, Version 1.0. (See accompanying
+ / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ /]
+
+[section:AcceptToken Accept token requirements]
+
+A accept token is a [link asio.overview.model.completion_tokens completion
+token] for completion signature `void(error_code)`.
+
+[heading Examples]
+
+A free function as a accept token:
+
+  void accept_handler(
+      const asio::error_code& ec)
+  {
+    ...
+  }
+
+A accept token function object:
+
+  struct accept_handler
+  {
+    ...
+    void operator()(
+        const asio::error_code& ec)
+    {
+      ...
+    }
+    ...
+  };
+
+A lambda as a accept token:
+
+  acceptor.async_accept(...,
+      [](const asio::error_code& ec)
+      {
+        ...
+      });
+
+A non-static class member function adapted to a accept token using
+`std::bind()`:
+
+  void my_class::accept_handler(
+      const asio::error_code& ec)
+  {
+    ...
+  }
+  ...
+  acceptor.async_accept(...,
+      std::bind(&my_class::accept_handler,
+        this, std::placeholders::_1));
+
+A non-static class member function adapted to a accept token using
+`boost::bind()`:
+
+  void my_class::accept_handler(
+      const asio::error_code& ec)
+  {
+    ...
+  }
+  ...
+  acceptor.async_accept(...,
+      boost::bind(&my_class::accept_handler,
+        this, asio::placeholders::error));
+
+Using [link asio.reference.use_future use_future] as a accept token:
+
+  std::future<void> f = acceptor.async_accept(..., asio::use_future);
+  ...
+  try
+  {
+    f.get();
+  }
+  catch (const system_error& e)
+  {
+    ...
+  }
+
+Using [link asio.reference.use_awaitable use_awaitable] as a accept token:
+
+  asio::awaitable<void> my_coroutine()
+  {
+    try
+    {
+      ...
+      co_await acceptor.async_accept(..., asio::use_awaitable);
+      ...
+    }
+    catch (const system_error& e)
+    {
+      ...
+    }
+  }
+
+[endsect]

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AcceptableProtocol.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AsyncRandomAccessReadDevice.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AsyncRandomAccessWriteDevice.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AsyncReadStream.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/AsyncWriteStream.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/BufferedHandshakeHandler.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -12,44 +12,4 @@ asio.reference.Handler handler]. A value `h` of a buffered handshake handler
 class should work correctly in the expression `h(ec, s)`, where `ec` is an
 lvalue of type `const error_code` and `s` is an lvalue of type `const size_t`.
 
-[heading Examples]
-
-A free function as a buffered handshake handler:
-
-  void handshake_handler(
-      const asio::error_code& ec,
-      std::size_t bytes_transferred)
-  {
-    ...
-  }
-
-A buffered handshake handler function object:
-
-  struct handshake_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec,
-        std::size_t bytes_transferred)
-    {
-      ...
-    }
-    ...
-  };
-
-A non-static class member function adapted to a buffered handshake handler
-using `boost::bind()`:
-
-  void my_class::handshake_handler(
-      const asio::error_code& ec,
-      std::size_t bytes_transferred)
-  {
-    ...
-  }
-  ...
-  socket.async_handshake(...,
-      boost::bind(&my_class::handshake_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::bytes_transferred));
-
 [endsect]

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/BufferedHandshakeToken.qbk

@@ -0,0 +1,111 @@
+[/
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ /
+ / Distributed under the Boost Software License, Version 1.0. (See accompanying
+ / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ /]
+
+[section:BufferedHandshakeToken SSL buffered handshake token requirements]
+
+A buffered_handshake token is a [link asio.overview.model.completion_tokens
+completion token] for completion signature `void(error_code, size_t)`.
+
+[heading Examples]
+
+A free function as a buffered_handshake token:
+
+  void buffered_handshake_handler(
+      const asio::error_code& ec,
+      std::size_t bytes_transferred)
+  {
+    ...
+  }
+
+A buffered_handshake token function object:
+
+  struct buffered_handshake_handler
+  {
+    ...
+    void operator()(
+        const asio::error_code& ec,
+        std::size_t bytes_transferred)
+    {
+      ...
+    }
+    ...
+  };
+
+A lambda as a buffered_handshake token:
+
+  ssl_stream.async_handshake(...,
+      [](const asio::error_code& ec,
+        std::size_t bytes_transferred)
+      {
+        ...
+      });
+
+A non-static class member function adapted to a buffered_handshake token using
+`std::bind()`:
+
+  void my_class::buffered_handshake_handler(
+      const asio::error_code& ec,
+      std::size_t bytes_transferred)
+  {
+    ...
+  }
+  ...
+  ssl_stream.async_handshake(...,
+      std::bind(&my_class::buffered_handshake_handler,
+        this, std::placeholders::_1,
+        std::placeholders::_2));
+
+A non-static class member function adapted to a buffered_handshake token using
+`boost::bind()`:
+
+  void my_class::buffered_handshake_handler(
+      const asio::error_code& ec,
+      std::size_t bytes_transferred)
+  {
+    ...
+  }
+  ...
+  ssl_stream.async_handshake(...,
+      boost::bind(&my_class::buffered_handshake_handler,
+        this, asio::placeholders::error,
+        asio::placeholders::bytes_transferred));
+
+Using [link asio.reference.use_future use_future] as a buffered handshake token:
+
+  std::future<std::size_t> f =
+    ssl_stream.async_handshake(..., asio::use_future);
+  ...
+  try
+  {
+    std::size_t n = f.get();
+    ...
+  }
+  catch (const system_error& e)
+  {
+    ...
+  }
+
+Using [link asio.reference.use_awaitable use_awaitable] as a buffered handshake
+token:
+
+  asio::awaitable<void> my_coroutine()
+  {
+    try
+    {
+      ...
+      std::size_t n =
+        co_await ssl_stream.async_handshake(
+            ..., asio::use_awaitable);
+      ...
+    }
+    catch (const system_error& e)
+    {
+      ...
+    }
+  }
+
+[endsect]

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/CancellationHandler.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/CancellationSlot.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/CompletionCondition.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/ConnectCondition.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

package/deps/couchbase-cxx-client/third_party/asio/asio/src/doc/requirements/ConnectHandler.qbk

@@ -1,5 +1,5 @@
 [/
- / Copyright (c) 2003-2021 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ / Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
  / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -12,61 +12,4 @@ asio.reference.Handler handler]. A value `h` of a connect handler
 class should work correctly in the expression `h(ec)`, where `ec` is an lvalue
 of type `const error_code`.
 
-[heading Examples]
-
-A free function as a connect handler:
-
-  void connect_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-
-A connect handler function object:
-
-  struct connect_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a connect handler:
-
-  socket.async_connect(...,
-      [](const asio::error_code& ec)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a connect handler using
-`std::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  socket.async_connect(...,
-      std::bind(&my_class::connect_handler,
-        this, std::placeholders::_1));
-
-A non-static class member function adapted to a connect handler using
-`boost::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  socket.async_connect(...,
-      boost::bind(&my_class::connect_handler,
-        this, asio::placeholders::error));
-
 [endsect]