1 file changed, 12 insertions, 7 deletions
diff --git a/source/ui-ssdiff.h b/source/ui-ssdiff.h
index 11f2714..f6489c8 100644
--- a/source/ui-ssdiff.h
+++ b/source/ui-ssdiff.h
@@ -1,9 +1,16 @@
-#ifndef UI_SSDIFF_H
-#define UI_SSDIFF_H
-
 /*
- * ssdiff line limits
+ * The side by side diff view, which ui-diff.c renders through when a reader
+ * asks for that layout rather than the unified one. Every call below is made
+ * as ui-diff.c walks a diff, so nothing here is a page of its own.
  */
+
+#ifndef CGIT_UI_SSDIFF_H
+#define CGIT_UI_SSDIFF_H
+
+// The longest old line and the longest new line the view will compare
+// character by character. The comparison fills a cell for every pair of
+// characters, so its cost is the product of the two, and a line past the limit
+// is shown whole instead.
 #ifndef MAX_SSDIFF_M
 #define MAX_SSDIFF_M 128
 #endif
@@ -13,8 +20,6 @@
 #endif
 #define MAX_SSDIFF_SIZE ((MAX_SSDIFF_M) * (MAX_SSDIFF_N))
 
-extern void cgit_ssdiff_print_deferred_lines(void);
-
 extern void cgit_ssdiff_line_cb(char *line, int len);
 
 extern void cgit_ssdiff_header_begin(void);
@@ -22,4 +27,4 @@ extern void cgit_ssdiff_header_end(void);
 
 extern void cgit_ssdiff_footer(void);
 
-#endif /* UI_SSDIFF_H */
+#endif // CGIT_UI_SSDIFF_H