improve a comment explaining a particularly nasty hack; no code change

1 files changed, 6 insertions, 1 deletions

diff --git a/read.c b/read.c
index 3f375dcf..28a55357 100644
--- a/read.c
+++ b/read.c
@@ -261,7 +261,12 @@ mparse_buf_r(struct mparse *curp, struct buf blk, size_t i, int start)
 			lastln = thisln;
 		}
 
-		/* XXX Ugly hack to mark the end of the input. */
+		/*
+		 * XXX Ugly hack to mark the end of the input,
+		 * such that the function roff_parse_comment()
+		 * doesn't attempt to append another line if the
+		 * last input line ends with an escape character.
+		 */
 
 		if (i == blk.sz || blk.buf[i] == '\0') {
 			if (pos + 2 > ln.sz)