X-Git-Url: https://git.ozlabs.org/?p=ccan;a=blobdiff_plain;f=ccan%2Fio%2F_info;h=235e6ba3d281df8ee8f7576030ceabcc9779e533;hp=8786272cb97723fba8dbf43310acb86f9b5a6302;hb=641b511049e5c03d45ada0c3fd829691b173e5d1;hpb=3a7b8a8a8081ebbb6457527de376dec6264bc381

diff --git a/ccan/io/_info b/ccan/io/_info
index 8786272c..235e6ba3 100644
--- a/ccan/io/_info
+++ b/ccan/io/_info
@@ -3,12 +3,18 @@
 #include "config.h"
 
 /**
- * io - simple library for stateful io handling.
- *
- * io provides a simple mechanism to write I/O servers with multiple
- * connections.  Handling of connections is multiplexed, and function
- * indicate what they want written or read, and what follow-on
- * function to call on success (or failure).
+ * io - simple library for asynchronous io handling.
+ *
+ * io provides a mechanism to write I/O servers with multiple
+ * connections.  Each callback indicates what I/O they plan next
+ * (eg. read, write).  It is also possible to write custom I/O
+ * plans.
+ *
+ * When compiled with DEBUG, control flow is changed so that rather
+ * than returning to the main io_loop(), plans are executed sequentially
+ * providing a backtrace showing what has occurred on that connection.
+ * Which connection(s) do this depends on the user-specified io_debug
+ * function.
  *
  * Example:
  * // Given tr A-Z a-z outputs tr a-z a-z