From 0b77fb38ba0c62f9f60c920ad6a1bd0b052c46a9 Mon Sep 17 00:00:00 2001
From: sof <unknown>
Date: Fri, 20 Jun 1997 09:19:19 +0000
Subject: [PATCH] [project @ 1997-06-20 09:19:19 by sof] Added mention of
possible cpp macro weirdness
---
docs/installing.lit | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/docs/installing.lit b/docs/installing.lit
index 2cf0f8815a99..63ccb138e4a2 100644
--- a/docs/installing.lit
+++ b/docs/installing.lit
@@ -1720,6 +1720,22 @@ will reach out and bite you. Yes, please complain; meanwhile,
you can do \tr{make -n whatever.dvi} to see the intended commands,
then try to muddle through, doing them by hand.
+%------------------------------------------------------------------------
+\item
+GHC's sources go through \tr{cpp}
+before being compiled, and \tr{cpp} varies a bit from one Unix to another.
+One particular gotcha is macro calls like this:
+\begin{verbatim}
+ SLIT("Hello, world")
+\end{verbatim}
+Some \tr{cpp}s treat the comma inside the string as separating two macro arguments,
+so you get
+\begin{verbatim}
+ :731: macro `SLIT' used with too many (2) args
+\end{verbatim}
+Alas, \tr{cpp} doesn't tell you the offending file!
+
+Workaround: don't put wierd things in string args to \tr{cpp} macros.
\end{enumerate}
--
GitLab