Index: trunk/src/action_helper.h
===================================================================
--- trunk/src/action_helper.h	(revision 13323)
+++ trunk/src/action_helper.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for action routines */
-
 #ifndef	PCB_ACTION_HELPER_H
 #define	PCB_ACTION_HELPER_H
 
Index: trunk/src/buffer.h
===================================================================
--- trunk/src/buffer.h	(revision 13323)
+++ trunk/src/buffer.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for buffer handling routines */
+/* Board independent paste buffers */
 
 #ifndef PCB_BUFFER_H
 #define PCB_BUFFER_H
Index: trunk/src/change.h
===================================================================
--- trunk/src/change.h	(revision 13323)
+++ trunk/src/change.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes to change object properties */
+/* Generic, object-type independent change calls */
 
 #ifndef	PCB_CHANGE_H
 #define	PCB_CHANGE_H
Index: trunk/src/clip.h
===================================================================
--- trunk/src/clip.h	(revision 13323)
+++ trunk/src/clip.h	(revision 13324)
@@ -25,17 +25,11 @@
  *
  */
 
-/* prototypes for inserting points into objects */
-
 #ifndef	PCB_CLIP_H
 #define	PCB_CLIP_H
 
 #include "global_typedefs.h"
 
-/* ---------------------------------------------------------------------------
- * prototypes
- */
-
 /* Clip X,Y to the given bounding box, plus a margin.  Returns pcb_true if
    there is something left to be drawn.  */
 pcb_bool pcb_line_clip(double minx, double miny, double maxx, double maxy,
Index: trunk/src/copy.h
===================================================================
--- trunk/src/copy.h	(revision 13323)
+++ trunk/src/copy.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for copy routines */
-
 #ifndef	PCB_COPY_H
 #define	PCB_COPY_H
 
Index: trunk/src/crosshair.h
===================================================================
--- trunk/src/crosshair.h	(revision 13323)
+++ trunk/src/crosshair.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for crosshair routines */
-
 #ifndef	PCB_CROSSHAIR_H
 #define	PCB_CROSSHAIR_H
 
Index: trunk/src/draw.h
===================================================================
--- trunk/src/draw.h	(revision 13323)
+++ trunk/src/draw.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for drawing routines */
-
 #ifndef	PCB_DRAW_H
 #define	PCB_DRAW_H
 
Index: trunk/src/error.h
===================================================================
--- trunk/src/error.h	(revision 13323)
+++ trunk/src/error.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for error and debug functions */
+/* Messages, error reporting and debug functions */
 
 #ifndef	PCB_ERROR_H
 #define	PCB_ERROR_H
Index: trunk/src/find.h
===================================================================
--- trunk/src/find.h	(revision 13323)
+++ trunk/src/find.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes connection search routines */
+/* Find galvanic/geometrical connections */
 
 #ifndef	PCB_FIND_H
 #define	PCB_FIND_H
Index: trunk/src/insert.h
===================================================================
--- trunk/src/insert.h	(revision 13323)
+++ trunk/src/insert.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for inserting points into objects */
+/* Inserting points into objects */
 
 #ifndef	PCB_INSERT_H
 #define	PCB_INSERT_H
@@ -33,9 +33,6 @@
 
 #define	PCB_INSERT_TYPES	(PCB_TYPE_POLY | PCB_TYPE_LINE | PCB_TYPE_ARC | PCB_TYPE_RATLINE)
 
-/* ---------------------------------------------------------------------------
- * prototypes
- */
 void *pcb_insert_point_in_object(int, void *, void *, pcb_cardinal_t *, pcb_coord_t, pcb_coord_t, pcb_bool, pcb_bool);
 pcb_point_t *pcb_adjust_insert_point(void);
 
Index: trunk/src/intersect.h
===================================================================
--- trunk/src/intersect.h	(revision 13323)
+++ trunk/src/intersect.h	(revision 13324)
@@ -29,8 +29,7 @@
  */
 
 
-/* prototypes for rectangle intersection/union routines.
- */
+/* Box (rectangle) intersection/union routines. */
 
 #ifndef PCB_INTERSECT_H
 #define PCB_INTERSECT_H
Index: trunk/src/misc_util.h
===================================================================
--- trunk/src/misc_util.h	(revision 13323)
+++ trunk/src/misc_util.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for misc routines - independent of PCB data types */
+/* misc - independent of PCB data types */
 
 #ifndef	PCB_MISC_UTIL_H
 #define	PCB_MISC_UTIL_H
Index: trunk/src/move.h
===================================================================
--- trunk/src/move.h	(revision 13323)
+++ trunk/src/move.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for move routines */
-
 #ifndef	PCB_MOVE_H
 #define	PCB_MOVE_H
 
@@ -47,9 +45,6 @@
 	(PCB_TYPE_LINE | PCB_TYPE_TEXT | PCB_TYPE_POLY | PCB_TYPE_RATLINE | PCB_TYPE_ARC)
 
 
-/* ---------------------------------------------------------------------------
- * prototypes
- */
 void *pcb_move_obj(int, void *, void *, void *, pcb_coord_t, pcb_coord_t);
 void *pcb_move_obj_to_layer(int, void *, void *, void *, pcb_layer_t *, pcb_bool);
 void *pcb_move_obj_and_rubberband(int, void *, void *, void *, pcb_coord_t, pcb_coord_t);
Index: trunk/src/obj_pinvia_therm.h
===================================================================
--- trunk/src/obj_pinvia_therm.h	(revision 13323)
+++ trunk/src/obj_pinvia_therm.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for thermal routines
+/* thermal on pins/vias
  *
  * Thermals are normal lines on the layout. The only thing unique
  * about them is that they have the PCB_FLAG_USETHERMAL set so that they
Index: trunk/src/polygon.h
===================================================================
--- trunk/src/polygon.h	(revision 13323)
+++ trunk/src/polygon.h	(revision 13324)
@@ -24,7 +24,8 @@
  *
  */
 
-/* prototypes for polygon editing routines */
+/* High level polygon support: pcb-specific polygon operations on complex
+   polygon objects with islands and holes */
 
 #ifndef	PCB_POLYGON_H
 #define	PCB_POLYGON_H
Index: trunk/src/rats.h
===================================================================
--- trunk/src/rats.h	(revision 13323)
+++ trunk/src/rats.h	(revision 13324)
@@ -26,8 +26,6 @@
  *
  */
 
-/* prototypes for rats routines */
-
 #ifndef PCB_RATS_H
 #define PCB_RATS_H
 
@@ -36,11 +34,6 @@
 #include "layer.h"
 #include "layer_grp.h"
 
-/* ---------------------------------------------------------------------------
- * structure used by device drivers
- */
-
-
 struct pcb_connection_s {  /* holds a connection (rat) */
 	pcb_coord_t X, Y;        /* coordinate of connection */
 	void *ptr1;              /* parent of ptr2??? */
Index: trunk/src/remove.h
===================================================================
--- trunk/src/remove.h	(revision 13323)
+++ trunk/src/remove.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for remove routines */
+/* Remove objects from the board */
 
 #ifndef	PCB_REMOVE_H
 #define	PCB_REMOVE_H
Index: trunk/src/rotate.h
===================================================================
--- trunk/src/rotate.h	(revision 13323)
+++ trunk/src/rotate.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for transform routines */
-
 #ifndef	PCB_ROTATE_H
 #define	PCB_ROTATE_H
 
Index: trunk/src/search.h
===================================================================
--- trunk/src/search.h	(revision 13323)
+++ trunk/src/search.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for search routines */
+/* Search object by location routines */
 
 #ifndef	PCB_SEARCH_H
 #define	PCB_SEARCH_H
@@ -37,10 +37,8 @@
 pcb_bool pcb_arc_in_box(pcb_arc_t *arc, pcb_box_t *b);
 
 #define PCB_SLOP 5
+
 /* ---------------------------------------------------------------------------
- * some useful macros
- */
-/* ---------------------------------------------------------------------------
  * some define to check for 'type' in box
  */
 #define	PCB_POINT_IN_BOX(x,y,b)	\
@@ -162,11 +160,6 @@
 #define PCB_ARC_NEAR_BOX(a,b) \
 	(PCB_IS_BOX_NEGATIVE(b) ? PCB_ARC_TOUCHES_BOX(a,b) : PCB_ARC_IN_BOX(a,b))
 
-
-
-/* ---------------------------------------------------------------------------
- * prototypes
- */
 pcb_bool pcb_is_point_on_line(pcb_coord_t, pcb_coord_t, pcb_coord_t, pcb_line_t *);
 pcb_bool pcb_is_point_in_pin(pcb_coord_t, pcb_coord_t, pcb_coord_t, pcb_pin_t *);
 pcb_bool pcb_is_point_on_arc(pcb_coord_t, pcb_coord_t, pcb_coord_t, pcb_arc_t *);
Index: trunk/src/select.h
===================================================================
--- trunk/src/select.h	(revision 13323)
+++ trunk/src/select.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for select routines */
-
 #ifndef	PCB_SELECT_H
 #define	PCB_SELECT_H
 
Index: trunk/src/undo.h
===================================================================
--- trunk/src/undo.h	(revision 13323)
+++ trunk/src/undo.h	(revision 13324)
@@ -24,8 +24,6 @@
  *
  */
 
-/* prototypes for undo routines */
-
 #ifndef	PCB_UNDO_H
 #define	PCB_UNDO_H
 
Index: trunk/src/undo_old.h
===================================================================
--- trunk/src/undo_old.h	(revision 13323)
+++ trunk/src/undo_old.h	(revision 13324)
@@ -24,7 +24,7 @@
  *
  */
 
-/* prototypes for undo routines */
+/* old undo infra: should be replaced by per operation local undo */
 
 #ifndef	PCB_UNDO_OLD_H
 #define	PCB_UNDO_OLD_H