Reamalgam after .h edits

PUBLISHED_FROM=da1faa9b46cd0ff22dcba6d324b5847c4a0d42d8

docs/c-api/mbuf.h/intro.md

@@ -14,7 +14,7 @@ items:
 ---
 
 Mbufs are mutable/growing memory buffers, like C++ strings.
-Mbuf can append data to the end of a buffer, or insert data into arbitrary
+Mbuf can append data to the end of a buffer or insert data into arbitrary
 position in the middle of a buffer. The buffer grows automatically when
 needed.
 

docs/c-api/mbuf.h/mbuf_append.md

@@ -8,5 +8,5 @@ signature: |
 
 Appends data to the Mbuf.
 
-Return the number of bytes appended, or 0 if out of memory. 
+Returns the number of bytes appended or 0 if out of memory. 
 

docs/c-api/mbuf.h/mbuf_free.md

@@ -6,5 +6,5 @@ signature: |
   void mbuf_free(struct mbuf *);
 ---
 
-Free the space allocated for the mbuffer and resets the mbuf structure. 
+Frees the space allocated for the mbuffer and resets the mbuf structure. 
 

docs/c-api/mbuf.h/mbuf_init.md

@@ -6,6 +6,6 @@ signature: |
   void mbuf_init(struct mbuf *, size_t initial_capacity);
 ---
 
-Initialize an Mbuf.
+Initialises an Mbuf.
 `initial_capacity` specifies the initial capacity of the mbuf. 
 

docs/c-api/mbuf.h/mbuf_insert.md

@@ -6,9 +6,9 @@ signature: |
   size_t mbuf_insert(struct mbuf *, size_t, const void *, size_t);
 ---
 
-Insert data at a specified offset in the Mbuf.
+Inserts data at a specified offset in the Mbuf.
 
 Existing data will be shifted forwards and the buffer will
 be grown if necessary.
-Return the number of bytes inserted. 
+Returns the number of bytes inserted. 
 

docs/c-api/mbuf.h/mbuf_remove.md

@@ -6,5 +6,5 @@ signature: |
   void mbuf_remove(struct mbuf *, size_t data_size);
 ---
 
-Remove `data_size` bytes from the beginning of the buffer. 
+Removes `data_size` bytes from the beginning of the buffer. 
 

docs/c-api/mbuf.h/mbuf_resize.md

@@ -6,7 +6,7 @@ signature: |
   void mbuf_resize(struct mbuf *, size_t new_size);
 ---
 
-Resize an Mbuf.
+Resizes an Mbuf.
 
 If `new_size` is smaller than buffer's `len`, the
 resize is not performed. 

docs/c-api/mbuf.h/mbuf_trim.md

@@ -6,5 +6,5 @@ signature: |
   void mbuf_trim(struct mbuf *);
 ---
 
-Shrink an Mbuf by resizing its `size` to `len`. 
+Shrinks an Mbuf by resizing its `size` to `len`.