Index: draw_eps.h
===================================================================
--- draw_eps.h	(revision 36262)
+++ draw_eps.h	(revision 36263)
@@ -21,8 +21,10 @@
 	double spare_d1, spare_d2, spare_d3, spare_d4;
 } rnd_eps_t;
 
+/* Set up context before the file is open */
 void rnd_eps_init(rnd_eps_t *pctx, rnd_box_t bounds, double scale, int in_mono, int as_shown);
 
+/* Set up output file and print header before export, footer after export */
 void rnd_eps_print_header(rnd_eps_t *pctx, const char *outfn, int ymirror);
 void rnd_eps_print_footer(rnd_eps_t *pctx);
 
@@ -46,11 +48,3 @@
 void rnd_eps_fill_polygon_offs(rnd_eps_t *pctx, rnd_hid_gc_t gc, int n_coords, rnd_coord_t *x, rnd_coord_t *y, rnd_coord_t dx, rnd_coord_t dy);
 void rnd_eps_fill_rect(rnd_eps_t *pctx, rnd_hid_gc_t gc, rnd_coord_t x1, rnd_coord_t y1, rnd_coord_t x2, rnd_coord_t y2);
 
-
-
-
-
-
-
-
-
Index: draw_ps.h
===================================================================
--- draw_ps.h	(revision 36262)
+++ draw_ps.h	(revision 36263)
@@ -38,28 +38,45 @@
 	double spare_d1, spare_d2, spare_d3, spare_d4;
 } rnd_ps_t;
 
+/* Set up context before the file is open */
 void rnd_ps_init(rnd_ps_t *pctx, rnd_hidlib_t *hidlib, FILE *f, int media_idx, int fillpage, double scale_factor);
 
+/* Call these whenever a new file is written */
 void rnd_ps_start_file(rnd_ps_t *pctx, const char *swver);
 void rnd_ps_end_file(rnd_ps_t *pctx);
 
+/* Wrap the table-of-contents (then export every page, but write a line of
+   ToC in set_layer_group() using rnd_ps_printed_toc(). Called once from
+   the main export loop. */
 void rnd_ps_begin_toc(rnd_ps_t *pctx);
 void rnd_ps_end_toc(rnd_ps_t *pctx);
+
+/* Wrap a normal output pages. Called once from the main export loop. */
 void rnd_ps_begin_pages(rnd_ps_t *pctx);
 void rnd_ps_end_pages(rnd_ps_t *pctx);
 
+/* Call this in set_layer_group(), if returns non-zero, return normally because
+   a ToC line got written */
 int rnd_ps_printed_toc(rnd_ps_t *pctx, int group, const char *name);
+
+/* Call this in set_layer_group() to see if a new page needs to be stated */
 int rnd_ps_is_new_page(rnd_ps_t *pctx, int group);
+
+/* Announce a new file, check for file open error */
 int rnd_ps_new_file(rnd_ps_t *pctx, FILE *new_f, const char *fn);
+
+/* Render frame and background of a new page, depending on pctx settings:
+   - mirror_this: apply y mirror (and announce it)
+   - noscale: turn off scale for this one page
+   - has_outline: pcb-rnd: whether the board has outline; others: 0
+   - page_is_route: pcb-rnd: whether this page contains boundary layers; others: 0
+   - min_wid: outline thickness */
 double rnd_ps_page_frame(rnd_ps_t *pctx, int mirror_this, const char *layer_fn, int noscale);
 void rnd_ps_page_background(rnd_ps_t *pctx, int has_outline, int page_is_route, rnd_coord_t min_wid);
 
+/* Standard HID API */
 rnd_hid_gc_t rnd_ps_make_gc(rnd_hid_t *hid);
 void rnd_ps_destroy_gc(rnd_hid_gc_t gc);
-void rnd_ps_use_gc(rnd_ps_t *pctx, rnd_hid_gc_t gc);
-
-void rnd_ps_set_drawing_mode(rnd_ps_t *pctx, rnd_hid_t *hid, rnd_composite_op_t op, rnd_bool direct, const rnd_box_t *screen);
-void rnd_ps_set_color(rnd_ps_t *pctx, rnd_hid_gc_t gc, const rnd_color_t *color);
 void rnd_ps_set_line_cap(rnd_hid_gc_t gc, rnd_cap_style_t style);
 void rnd_ps_set_line_width(rnd_hid_gc_t gc, rnd_coord_t width);
 void rnd_ps_set_draw_xor(rnd_hid_gc_t gc, int xor_);
@@ -66,6 +83,9 @@
 void rnd_ps_set_draw_faded(rnd_hid_gc_t gc, int faded);
 void rnd_ps_set_crosshair(rnd_hid_t *hid, rnd_coord_t x, rnd_coord_t y, int action);
 
+/* Standard HID API with extra pctx first arg */
+void rnd_ps_set_drawing_mode(rnd_ps_t *pctx, rnd_hid_t *hid, rnd_composite_op_t op, rnd_bool direct, const rnd_box_t *screen);
+void rnd_ps_set_color(rnd_ps_t *pctx, rnd_hid_gc_t gc, const rnd_color_t *color);
 void rnd_ps_draw_rect(rnd_ps_t *pctx, rnd_hid_gc_t gc, rnd_coord_t x1, rnd_coord_t y1, rnd_coord_t x2, rnd_coord_t y2);
 void rnd_ps_draw_line(rnd_ps_t *pctx, rnd_hid_gc_t gc, rnd_coord_t x1, rnd_coord_t y1, rnd_coord_t x2, rnd_coord_t y2);
 void rnd_ps_draw_arc(rnd_ps_t *pctx, rnd_hid_gc_t gc, rnd_coord_t cx, rnd_coord_t cy, rnd_coord_t width, rnd_coord_t height, rnd_angle_t start_angle, rnd_angle_t delta_angle);
@@ -76,3 +96,4 @@
 
 /*** for pcb-rnd only ***/
 int rnd_ps_gc_get_erase(rnd_hid_gc_t gc);
+void rnd_ps_use_gc(rnd_ps_t *pctx, rnd_hid_gc_t gc);