doc and version bump to 0.2.0

configure/CONFIG_PVXS_VERSION

@@ -1,3 +1,3 @@
 PVXS_MAJOR_VERSION = 0
-PVXS_MINOR_VERSION = 1
-PVXS_MAINTENANCE_VERSION = 6
+PVXS_MINOR_VERSION = 2
+PVXS_MAINTENANCE_VERSION = 0

documentation/client.rst

@@ -176,6 +176,18 @@ the event queue
 .. doxygenstruct:: pvxs::client::Subscription
     :members:
 
+Connect
+^^^^^^^
+
+Request that a Channel be created now which may be used by other Operations,
+allowing them to complete more quickly.
+
+.. doxygenclass:: pvxs::client::ConnectBuilder
+    :members:
+
+.. doxygenstruct:: pvxs::client::Connect
+    :members:
+
 Threading
 ^^^^^^^^^
 

documentation/releasenotes.rst

@@ -3,9 +3,25 @@
 Release Notes
 =============
 
-0.1.6 (UNRELEASED)
+0.2.0 (UNRELEASED)
 ------------------
 
+* Changes
+
+ * To simplify usage in situations with complex threading, many client methods avoid unnecessary
+   synchronization with the client worker thread.
+   Cancellation still synchronizes by default, but this may now be controlled with
+   the new syncCancel() Builder methods.  cf. `pvxs::client::detail::CommonBuilder::syncCancel()`.
+
+* Additions
+
+ * Add server ignore address list.  cf. `pvxs::server::Config::ignoreAddrs`.  Configured from $EPICS_PVAS_IGNORE_ADDR_LIST.
+ * Allow TCP timeout to be configured.
+ * Add `pvxs::client::Context::connect()` to force Channel creation and retention.
+ * Add `pvxs::client::Subscription::shared_from_this()` which can be used with eg. `pvxs::MPMCFIFO` (also newly added).
+ * Add per Server/Context statistical reporting of network bandwidth used by TCP connection, and by Channel.
+   cf. `pvxs::client::Context::report()` and `pvxs::server::Server::report()`.
+
 0.1.5 (May 2021)
 ----------------
 

src/pvxs/client.h

@@ -807,6 +807,7 @@ public:
     //! Handler to be invoked when channel becomes disconnected.
     ConnectBuilder& onDisconnect(std::function<void()>&& cb) { _onDis = std::move(cb); return *this; }
 
+    //! Submit request to connect
     PVXS_API
     std::shared_ptr<Connect> exec();
 };