some domments added

bubulles.h

@@ -4,7 +4,7 @@
 
 /* --------------------------------------------------------------------- */
 
-#define LIBBB_VERSION		50
+#define LIBBB_VERSION		51
 
 #define SZ_BUBULLE_TEXT		51		/* arbitrary value */
 
@@ -59,8 +59,23 @@ void	bubulles_sizeof(int k);
 
 Bubulle * bubulle_getaddr(BBList *where, int idx);
 
-int fprint_bubulles(FILE *fp, char *title, BBList *bbl, int k);
+/*
+ *	export functions
+ */
+
+/*
+ *		export Awk machinable.
+ * flags :
+ *	0x0001		print diameter
+ *	0x0002		print graylevel
+ *	0x0004		print RGB values
+ */
+int fprint_bubulles(FILE *fp, char *title, BBList *bbl, int flags);
+
+/* only human readable */
 int niceprint_bubulle(Bubulle *what, int unused);
+
+/* this is just a wtf function * see tbb.c */
 int bubulles_to_data(char *fname, char *title, BBList *bbl, int k);
 
 /* --------------------------------------------------------------------- */