render: Add comment.

diff --git a/src/output/render.c b/src/output/render.c
index f31fd3b9b57b079f0fd350fc9c6e289beed34ba2..c746faaa12f05817d57e8ccb3458a1147b0c5408 100644 (file)
--- a/src/output/render.c
+++ b/src/output/render.c
@@ -1474,6 +1474,10 @@ struct render_pager
   {
     const struct render_params *params;
 
+    /* An array of "render_page"s to be rendered, in order, vertically.  From
+       the user's perspective, there's only one table per render_pager, but the
+       implementation treats the title, table body, caption, footnotes,
+       etc. each as a table, and that's why we have an array here. */
     struct render_page **pages;
     size_t n_pages, allocated_pages;