A little cleanup, and some work on LpxClient

luprex/core/cpp/drivenengine.hpp

@@ -178,6 +178,7 @@ private:
     bool readline_enabled_;
     friend class DrivenEngine;
 };
+
 using UniqueChannel = std::unique_ptr<Channel>;
 
 class DrivenEngine {
@@ -206,7 +207,14 @@ public:
     //
     double get_clock();
 
-    // Create a channel and open an outgoing connection.
+    // Create a channel and open an outgoing connection.  The channel creation
+    // always succeeds.  You can write to the channel immediately.  You can
+    // read, too, but of course there won't be anything in the incoming buffer
+    // yet.  In future update events, data will show up in the incoming buffer,
+    // and will have been sent from the outgoing buffer.  In future update
+    // events, the channel may get closed by the remote.  If the connection
+    // fails (say, the remote host doesn't exist), then the Channel will get
+    // closed with an error.
     //
     // DRIVER: The channel object is created instantly, but it does nothing
     // until the driver notices the new channel.  The driver is responsible for