comparison vamp-client/CapnpRRClient.h @ 209:ac4f5f8ee0e7

Merge branch 'dev/step-and-block-size'

  * RpcRequest/RpcResponse structures with a single process call rather
  * than having individual RPC methods, with a synchronous transport
  * such as a subprocess pipe arrangement. Only one request can be
  * handled at a time. This class is thread-safe if and only if it is
  * constructed with a thread-safe SynchronousTransport implementation.
+ *
+ * This class takes Vamp-like structures (Plugin and the classes in
+ * vamp-support) and uses them to communicate with a Piper server
+ * using the Cap'n Proto serialisation of the Piper API. The transport
+ * layer (and thus the nature of the server) is defined by the
+ * SynchronousTransport passed to the constructor.
+ *
+ * This class implements both the Loader interface (which constructs
+ * PluginStub objects) and the PluginClient (which accepts PluginStubs
+ * and maps them into Piper handles).
  */
 class CapnpRRClient : public PluginClient,
                       public Loader
 {
     // unsigned to avoid undefined behaviour on possible wrap