..

src/HTMLRenderer/HTMLRenderer.h

@@ -379,6 +379,7 @@ class HTMLRenderer : public OutputDev
         double draw_tx, draw_ty; 
 
         // some metrics have to be determined after all elements in the lines have been seen
+        // see TextLineBuffer.h
         class TextLineBuffer;
         friend class TextLineBuffer;
         TextLineBuffer * text_line_buf;

src/HTMLRenderer/TextLineBuffer.h

@@ -6,6 +6,13 @@
 
 namespace pdf2htmlEX {
 
+/*
+ * Store a series of 
+ *  - Text
+ *  - Shift
+ *  - State change
+ * within a line
+ */
 class HTMLRenderer;
 class HTMLRenderer::TextLineBuffer
 {