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

diff --git a/read.c b/read.c
index 5b33edbe9cef4ef528ba141832e61b490edf52a3..0e8d32df5a5efd6c13f83bbd7014bf7d95a11c75 100644 (file)
--- a/read.c
+++ b/read.c
@@ -1,4 +1,4 @@
-/* $Id: read.c,v 1.220 2021/06/27 17:57:54 schwarze Exp $ */
+/* $Id: read.c,v 1.221 2022/05/19 14:48:56 schwarze Exp $ */
 /*
  * Copyright (c) 2010-2020 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -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)