lib: buffer - Improve header comment for buffer_insert() and buffer_delete().

diff --git a/src/lib/buffer.h b/src/lib/buffer.h
index 3428e60dec0137276077ce975ff08940e29cab50..601d1b43bea308dc2caf31a0c4d8977336ecf86d 100644 (file)
--- a/src/lib/buffer.h
+++ b/src/lib/buffer.h
@@ -51,10 +51,13 @@ void buffer_append(buffer_t *buf, const void *data, size_t data_size);
 /* Append character to buffer. */
 void buffer_append_c(buffer_t *buf, unsigned char chr);
 
-/* Insert data to buffer. */
+/* Insert the provided data into the buffer at position pos. If pos points past
+   the current buffer size, the gap is zero-filled. */
 void buffer_insert(buffer_t *buf, size_t pos,
                   const void *data, size_t data_size);
-/* Delete data from buffer. */
+/* Delete data with the indicated size from the buffer at position pos. The
+   deleted block may cross the current buffer size boundary, which is ignored.
+ */
 void buffer_delete(buffer_t *buf, size_t pos, size_t size);
 
 /* Fill buffer with zero bytes. */