1 file changed, 20 insertions, 3 deletions
diff --git a/source/ui-refs.h b/source/ui-refs.h
index 1d4a54a..c66050b 100644
--- a/source/ui-refs.h
+++ b/source/ui-refs.h
@@ -1,8 +1,25 @@
-#ifndef UI_REFS_H
-#define UI_REFS_H
+/*
+ * The branch and tag listings of a repository. The two section printers write
+ * rows into a table the caller has already opened, which is how the summary
+ * page carries a short version of each above its recent log.
+ */
 
+#ifndef CGIT_UI_REFS_H
+#define CGIT_UI_REFS_H
+
+/*
+ * Rows for the newest branches or tags, at most maxcount of them, where a
+ * maxcount of zero means every one. A section that leaves refs out ends in a
+ * link to the matching form of the refs page.
+ */
 extern void cgit_print_branches(int maxcount);
 extern void cgit_print_tags(int maxcount);
+
+/*
+ * The whole refs page. Without a path it holds a capped section of each kind,
+ * and with a path of heads or tags it becomes a page of that one kind alone,
+ * walked an offset at a time.
+ */
 extern void cgit_print_refs(void);
 
-#endif /* UI_REFS_H */
+#endif // CGIT_UI_REFS_H