couchbase 3.0.0-universal-darwin-19 → 3.0.1-universal-darwin-19

data/ext/third_party/asio/asio/src/doc/requirements/CompletionHandler.qbk

@@ -1,63 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:CompletionHandler Completion handler requirements]
-
-A completion handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a completion handler
-class should work correctly in the expression `h()`.
-
-[heading Examples]
-
-A free function as a completion handler:
-
-  void completion_handler()
-  {
-    ...
-  }
-
-A completion handler function object:
-
-  struct completion_handler
-  {
-    ...
-    void operator()()
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a completion handler:
-
-  my_io_service.post(
-      []()
-      {
-        ...
-      });
-
-A non-static class member function adapted to a completion handler using
-`std::bind()`:
-
-  void my_class::completion_handler()
-  {
-    ...
-  }
-  ...
-  my_io_service.post(std::bind(&my_class::completion_handler, this));
-
-A non-static class member function adapted to a completion handler using
-`boost::bind()`:
-
-  void my_class::completion_handler()
-  {
-    ...
-  }
-  ...
-  my_io_service.post(boost::bind(&my_class::completion_handler, this));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/ConnectCondition.qbk

@@ -1,34 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:ConnectCondition Connect condition requirements]
-
-A type `X` meets the `ConnectCondition` requirements if it satisfies the
-requirements of `Destructible` (C++Std [destructible]) and
-`CopyConstructible` (C++Std [copyconstructible]), as well as the additional
-requirements listed below.
-
-In the table below, `x` denotes a value of type `X`, `ec` denotes a (possibly
-const) value of type `error_code`, and `ep` denotes a (possibly const) value of
-some type satisfying the [link asio.reference.Endpoint endpoint] requirements.
-
-[table ConnectCondition requirements
-  [[expression] [return type] [assertion/note[br]pre/post-condition]]
-  [
-    [`x(ec, ep)`]
-    [`bool`]
-    [
-      Returns `true` to indicate that the `connect` or `async_connect`
-      algorithm should attempt a connection to the endpoint `ep`. Otherwise,
-      returns `false` to indicate that the algorithm should not attempt
-      connection to the endpoint `ep`, and should instead skip to the next
-      endpoint in the sequence.
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/ConnectHandler.qbk

@@ -1,72 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:ConnectHandler Connect handler requirements]
-
-A connect handler must meet the requirements for a [link
-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]

data/ext/third_party/asio/asio/src/doc/requirements/ConstBufferSequence.qbk

@@ -1,53 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:ConstBufferSequence Constant buffer sequence requirements]
-
-A ['constant buffer sequence] represents a set of memory regions that may be
-used as input to an operation, such as the `send` operation of a socket.
-
-A type `X` meets the `ConstBufferSequence` requirements if it satisfies the
-requirements of `Destructible` (C++Std [destructible]) and
-`CopyConstructible` (C++Std [copyconstructible]), as well as the additional
-requirements listed below.
-
-In the table below, `x` denotes a (possibly const) value of type `X`, and `u`
-denotes an identifier.
-
-[table ConstBufferSequence requirements
-  [[expression] [return type] [assertion/note[br]pre/post-condition]]
-  [
-    [`asio::buffer_sequence_begin(x)`[br]
-     `asio::buffer_sequence_end(x)`]
-    [An iterator type meeting the requirements for bidirectional iterators
-     (C++Std \[bidirectional.iterators\]) whose value type is convertible to
-     `const_buffer`.]
-    []
-  ]
-  [
-    [``
-      X u(x);
-    ``]
-    []
-    [post:[br]
-     ``
-       equal(
-         asio::buffer_sequence_begin(x),
-         asio::buffer_sequence_end(x),
-         asio::buffer_sequence_begin(u),
-         asio::buffer_sequence_end(u),
-         [](const const_buffer& b1,
-            const const_buffer& b2)
-          {
-            return b1.data() == b2.data()
-                && b1.size() == b2.size();
-          })
-     ``]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/DynamicBuffer.qbk

@@ -1,16 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:DynamicBuffer Dynamic buffer requirements]
-
-See:
-
-* [link asio.reference.DynamicBuffer_v1 Dynamic buffer requirements (version 1)]
-
-* [link asio.reference.DynamicBuffer_v2 Dynamic buffer requirements (version 2)]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/DynamicBuffer_v1.qbk

@@ -1,93 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:DynamicBuffer_v1 Dynamic buffer requirements (version 1)]
-
-A dynamic buffer encapsulates memory storage that may be automatically resized
-as required, where the memory is divided into an input sequence followed by an
-output sequence. These memory regions are internal to the dynamic buffer
-sequence, but direct access to the elements is provided to permit them to be
-efficiently used with I/O operations, such as the `send` or `receive`
-operations of a socket. Data written to the output sequence of a dynamic buffer
-sequence object is appended to the input sequence of the same object.
-
-A dynamic buffer type `X` shall satisfy the requirements of `MoveConstructible`
-(C++ Std, [moveconstructible]) types in addition to those listed below.
-
-In the table below, `X` denotes a dynamic buffer class, `x` denotes a
-value of type `X&`, `x1` denotes values of type `const X&`, and `n` denotes a
-value of type `size_t`, and `u` denotes an identifier.
-
-[table DynamicBuffer_v1 requirements
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`X::const_buffers_type`]
-    [type meeting [link asio.reference.ConstBufferSequence ConstBufferSequence]
-     requirements.]
-    [This type represents the memory associated with the input sequence.]
-  ]
-  [
-    [`X::mutable_buffers_type`]
-    [type meeting [link asio.reference.MutableBufferSequence MutableBufferSequence]
-     requirements.]
-    [This type represents the memory associated with the output sequence.]
-  ]
-  [
-    [`x1.size()`]
-    [`size_t`]
-    [Returns the size, in bytes, of the input sequence.]
-  ]
-  [
-    [`x1.max_size()`]
-    [`size_t`]
-    [Returns the permitted maximum of the sum of the sizes of the input
-     sequence and output sequence.]
-  ]
-  [
-    [`x1.capacity()`]
-    [`size_t`]
-    [Returns the maximum sum of the sizes of the input sequence and output
-     sequence that the dynamic buffer can hold without requiring reallocation.]
-  ]
-  [
-    [`x1.data()`]
-    [`X::const_buffers_type`]
-    [Returns a constant buffer sequence `u` that represents the memory
-     associated with the input sequence, and where `buffer_size(u) == size()`.]
-  ]
-  [
-    [`x.prepare(n)`]
-    [`X::mutable_buffers_type`]
-    [Requires: `size() + n <= max_size()`.[br]
-     [br]
-     Returns a mutable buffer sequence `u` representing the output sequence, and
-     where `buffer_size(u) == n`. The dynamic buffer reallocates memory as
-     required. All constant or mutable buffer sequences previously obtained
-     using `data()` or `prepare()` are invalidated.[br]
-     [br]
-     Throws: `length_error` if `size() + n > max_size()`.]
-  ]
-  [
-    [`x.commit(n)`]
-    []
-    [Appends `n` bytes from the start of the output sequence to the end of the
-     input sequence. The remainder of the output sequence is discarded. If `n`
-     is greater than the size of the output sequence, the entire output sequence
-     is appended to the input sequence. All constant or mutable buffer sequences
-     previously obtained using `data()` or `prepare()` are invalidated.]
-  ]
-  [
-    [`x.consume(n)`]
-    []
-    [Removes `n` bytes from beginning of the input sequence. If `n` is greater
-     than the size of the input sequence, the entire input sequence is removed.
-     All constant or mutable buffer sequences previously obtained using `data()`
-     or `prepare()` are invalidated.]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/DynamicBuffer_v2.qbk

@@ -1,94 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:DynamicBuffer_v2 Dynamic buffer requirements (version 2)]
-
-A dynamic buffer encapsulates memory storage that may be automatically resized
-as required.
-
-A dynamic buffer type `X` shall satisfy the requirements of `CopyConstructible`
-(C++ Std, [copyconstructible]) types in addition to those listed below.
-
-In the table below, `X` denotes a dynamic buffer class, `x` denotes a value of
-type `X&`, `x1` denotes values of type `const X&`, `pos` and `n` denote values
-of type `size_t`, and `u` denotes an identifier.
-
-[table DynamicBuffer_v2 requirements
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`X::const_buffers_type`]
-    [type meeting [link asio.reference.ConstBufferSequence ConstBufferSequence]
-     requirements.]
-    [This type represents the underlying memory as a sequence of @c const_buffer
-     objects.]
-  ]
-  [
-    [`X::mutable_buffers_type`]
-    [type meeting [link asio.reference.MutableBufferSequence MutableBufferSequence]
-     requirements.]
-    [This type represents the underlying memory as a sequence of @c
-     mutable_buffer objects.]
-  ]
-  [
-    [`x1.size()`]
-    [`size_t`]
-    [Returns the size, in bytes, of the underlying memory.]
-  ]
-  [
-    [`x1.max_size()`]
-    [`size_t`]
-    [Returns the permitted maximum size of the underlying memory.]
-  ]
-  [
-    [`x1.capacity()`]
-    [`size_t`]
-    [Returns the maximum size to which the underlying memory can grow without
-     requiring reallocation.]
-  ]
-  [
-    [`x1.data(pos, n)`]
-    [`X::const_buffers_type`]
-    [Returns a constant buffer sequence `u` that represents the underlying
-     memory beginning at offset `pos`, and where `buffer_size(u) <= n`.]
-  ]
-  [
-    [`x.data(pos, n)`]
-    [`X::mutable_buffers_type`]
-    [Returns a mutable buffer sequence `u` that represents the underlying
-     memory beginning at offset `pos`, and where `buffer_size(u) <= n`.]
-  ]
-  [
-    [`x.grow(n)`]
-    []
-    [Requires: `size() + n <= max_size()`.[br]
-     [br]
-     Extends the underlying memory to accommodate `n` additional bytes at the
-     end. The dynamic buffer reallocates memory as required. All constant or
-     mutable buffer sequences previously obtained using `data()` are
-     invalidated.[br]
-     [br]
-     Throws: `length_error` if `size() + n > max_size()`.]
-  ]
-  [
-    [`x.shrink(n)`]
-    []
-    [Removes `n` bytes from the end of the underlying memory. If `n` is greater
-     than the size of the underlying memory, the entire underlying memory is
-     emptied. All constant or mutable buffer sequences previously obtained
-     using `data()` are invalidated.]
-  ]
-  [
-    [`x.consume(n)`]
-    []
-    [Removes `n` bytes from the beginning of the underlying memory. If `n` is
-     greater than the size of the underlying memory, the entire underlying memory
-     is emptied. All constant or mutable buffer sequences previously obtained
-     using `data()` are invalidated.]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/Endpoint.qbk

@@ -1,97 +0,0 @@
-[/
- / Copyright (c) 2003-2020 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:Endpoint Endpoint requirements]
-
-A type `X` meets the `Endpoint` requirements if it satisfies the requirements
-of `Destructible` (C++Std [destructible]), `DefaultConstructible` (C++Std
-[defaultconstructible]), `CopyConstructible` (C++Std [copyconstructible]),
-and `CopyAssignable` (C++Std [copyassignable]), as well as the additional
-requirements listed below.
-
-The default constructor and move operations of the type `X` shall not exit via
-an exception.
-
-In the table below, `a` denotes a (possibly const) value of type `X`, and `u`
-denotes an identifier.
-
-[table Endpoint requirements
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`X::protocol_type`]
-    [type meeting [link asio.reference.Protocol `Protocol`] requirements]
-    []
-  ]
-  [
-    [`a.protocol()`]
-    [`protocol_type`]
-    []
-  ]
-]
-
-In the table below, `a` denotes a (possibly const) value of type `X`, `b`
-denotes a value of type `X`, and `s` denotes a (possibly const) value of a type
-that is convertible to `size_t` and denotes a size in bytes.
-
-[table Endpoint requirements for extensible implementations
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`a.data()`]
-    [`const void*`]
-    [
-      Returns a pointer suitable for passing as the /address/ argument to
-      functions such as __POSIX__ __connect__, or as the /dest_addr/ argument
-      to functions such as  __POSIX__ __sendto__. The implementation shall
-      perform a `static_cast` on the pointer to convert it to `const
-      sockaddr*`.
-    ]
-  ]
-  [
-    [`b.data()`]
-    [`void*`]
-    [
-      Returns a pointer suitable for passing as the /address/ argument to
-      functions such as __POSIX__ __accept__, __getpeername__, __getsockname__
-      and __recvfrom__. The implementation shall perform a `static_cast` on the
-      pointer to convert it to `sockaddr*`.
-    ]
-  ]
-  [
-    [`a.size()`]
-    [`size_t`]
-    [
-      Returns a value suitable for passing as the /address_len/ argument
-      to functions such as __POSIX__ __connect__, or as the /dest_len/ argument
-      to functions such as __POSIX__ __sendto__, after appropriate integer
-      conversion has been performed.
-    ]
-  ]
-  [
-    [`b.resize(s)`]
-    []
-    [
-      pre: `s >= 0`[br]
-      post: `a.size() == s`[br]
-      Passed the value contained in the /address_len/ argument to functions
-      such as __POSIX__ __accept__, __getpeername__, __getsockname__ and
-      __recvfrom__, after successful completion of the function. Permitted to
-      throw an exception if the protocol associated with the endpoint object
-      `a` does not support the specified size.
-    ]
-  ]
-  [
-    [`a.capacity()`]
-    [`size_t`]
-    [
-      Returns a value suitable for passing as the /address_len/ argument to
-      functions such as __POSIX__ __accept__, __getpeername__, __getsockname__
-      and __recvfrom__, after appropriate integer conversion has been performed.
-    ]
-  ]
-]
-
-[endsect]