From 61a3fbc0192d19348746e77850b4e3b3866e30f5 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Thu, 17 Jun 2021 09:43:40 -1000
Subject: [PATCH] ;shake: note how paragraph refilling affects macro arguments
 (#806)

---
 Shake.hs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Shake.hs b/Shake.hs
index fb09ff455..0d3ad1dcf 100755
--- a/Shake.hs
+++ b/Shake.hs
@@ -111,6 +111,12 @@ sed = "sed -E"
 grep = "grep -E"
 
 -- The kind of markdown used in our doc source files.
+-- Note: without +hard_line_breaks here, paragraphs get refilled,
+-- which is good for nice rendered info/man/text output, but so do
+-- multiline arguments to m4 macros, which is bad eg when using
+-- _info_ to add Info directives (cf #806). For such situations we
+-- work around by calling the macro for each line of text, it
+-- would be nice to find a way to avoid this.
 fromsrcmd = "-f markdown-smart-tex_math_dollars"
 
 -- The kind of markdown we like to generate for the website.