struct iobuf doc

docs/README.md

@@ -1354,12 +1354,17 @@ Usage example:
 
 ## IO Buffers
 
+IO buffer, described by the `struct mg_iobuf`, is a simple data structure
+that insert or delete chunks of data at arbitrary offsets and grow/shrink
+automatically.
+
 ### struct mg\_iobuf
 
 ```c
 struct mg_iobuf {
-  unsigned char *buf;
-  size_t size, len;
+  unsigned char *buf;  // Pointer to stored data
+  size_t size;         // Total size available
+  size_t len;          // Current number of bytes
 };
 ```
 

mongoose.h

@@ -628,7 +628,7 @@ const char *mg_url_uri(const char *url);
 #include <stddef.h>
 
 struct mg_iobuf {
-  unsigned char *buf;  // Data
+  unsigned char *buf;  // Pointer to stored data
   size_t size;         // Total size available
   size_t len;          // Current number of bytes
 };

src/iobuf.h

@@ -3,7 +3,7 @@
 #include <stddef.h>
 
 struct mg_iobuf {
-  unsigned char *buf;  // Data
+  unsigned char *buf;  // Pointer to stored data
   size_t size;         // Total size available
   size_t len;          // Current number of bytes
 };