Index: trunk/src/buffer.c
===================================================================
--- trunk/src/buffer.c	(revision 13355)
+++ trunk/src/buffer.c	(revision 13356)
@@ -398,9 +398,6 @@
 	return 0;
 }
 
-/* ---------------------------------------------------------------------------
- * initializes the buffers by allocating memory
- */
 void pcb_init_buffers(pcb_board_t *pcb)
 {
 	int i;
@@ -446,10 +443,6 @@
 	pcb_set_buffer_bbox(Buffer);
 }
 
-
-/* ---------------------------------------------------------------------------
- * flip components/tracks from one side to the other
- */
 void pcb_buffer_flip_side(pcb_board_t *pcb, pcb_buffer_t *Buffer)
 {
 	int j, k;
Index: trunk/src/buffer.h
===================================================================
--- trunk/src/buffer.h	(revision 13355)
+++ trunk/src/buffer.h	(revision 13356)
@@ -57,9 +57,14 @@
 void pcb_buffer_rotate(pcb_buffer_t *Buffer, pcb_uint8_t Number);
 void pcb_buffer_free_rotate(pcb_buffer_t *Buffer, pcb_angle_t angle);
 
+/* flip elements/subcircuits/tracks from one side to the other; also swap
+   the layer stackup of padstacks */
 void pcb_buffers_flip_side(pcb_board_t *pcb);
+
+/* graphically mirror the buffer on the current side */
 void pcb_buffer_mirror(pcb_board_t *pcb, pcb_buffer_t *Buffer);
 
+/* Init/uninit all buffers (stored in board-independent global variables) */
 void pcb_init_buffers(pcb_board_t *pcb);
 void pcb_uninit_buffers(pcb_board_t *pcb);