--- a/buf.h	Mon Mar 12 21:49:59 2012 +0100
+++ b/buf.h	Tue Mar 20 22:49:37 2012 +0100
@@ -19,12 +19,12 @@
 #ifndef _BUF_H_
 #define _BUF_H_
 
+#include <stdarg.h>
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-#include <stdarg.h>
-
 #ifndef BUF_DEFAULT_BSIZE
 #define BUF_DEFAULT_BSIZE	128
 #endif
@@ -46,11 +46,11 @@
 };
 
 struct buf {
-	int		flags;	/* string flags */
-	char		*text;	/* string text */
-	size_t		length;	/* string length */
-	size_t		alsize;	/* allocated size */
-	int		bsize;	/* block size (used when growing array) */
+	int		flags;		/* (ro) string flags */
+	char		*text;		/* (ro) string text */
+	size_t		length;		/* (ro) string length */
+	size_t		alsize;		/* (ro) allocated size */
+	int		bsize;		/* (ro) block size (used when growing */
 
 	/* Own allocation functions */
 	void * (*malloc)(size_t);