buffer: add some comments to clarify allocation strategy

Closes #116

1 files changed, 3 insertions, 0 deletions

diff --git a/buffer.c b/buffer.c
index 6a16a7b..1577e6f 100644
--- a/buffer.c
+++ b/buffer.c
@@ -11,9 +11,12 @@ void buffer_init(Buffer *buf) {
 }
 
 bool buffer_grow(Buffer *buf, size_t size) {
+	/* ensure minimal buffer size, to avoid repeated realloc(3) calls */
 	if (size < BUF_SIZE)
 		size = BUF_SIZE;
 	if (buf->size < size) {
+		/* if this is not the first allocation i.e. the buffer is
+		 * currently full, double the size to avoid memory pressure */
 		if (buf->size > 0)
 			size *= 2;
 		char *data = realloc(buf->data, size);