un peu de clarifications

bubulles.h

@@ -20,6 +20,10 @@ typedef struct {
 	unsigned long	reserved;
 	} RGBA;	
 
+/*
+           this is our main entity : the bubulle.
+   'bubulle' is a slang french word for 'friendly bubble'.
+*/
 typedef struct {
 	XYZ		p;			/* position */
 	double  	d;			/* diameter */
@@ -29,15 +33,19 @@ typedef struct {
 	double		kvalue;			/* wtf ? */
 	} Bubulle;
 
+/*
+   this is the bubulles list descriptor.
+*/
 typedef struct {
 	char		name[SZ_BUBULLE_TEXT+1];
 	int		size;			/* max number of bubulles */
 	int		fidx;			/* next free slot */
-	XYZ		position;
+	XYZ		position;		/* global position */
 	unsigned long	flags;
-	Bubulle		*bbs;
+	Bubulle		*bbs;			/* ptr to a movable array */
 	} BBList;
 
+
 BBList * alloc_bubulles(char *name, int nbre, int k);
 int	free_bubulles(BBList *bbl, int k);
 int	print_bublist_desc(BBList *bbl, int k);