From 99e6291a8a9a04628cce7518d05117c3e230dcff Mon Sep 17 00:00:00 2001
From: simonm <unknown>
Date: Tue, 23 Sep 1997 15:32:20 +0000
Subject: [PATCH] [project @ 1997-09-23 15:32:20 by simonm] Add information on
how to mix -cpp and string gaps.
---
ghc/docs/users_guide/how_to_run.lit | 18 ++++++++++++++++--
1 file changed, 16 insertions(+), 2 deletions(-)
diff --git a/ghc/docs/users_guide/how_to_run.lit b/ghc/docs/users_guide/how_to_run.lit
index 52617eff60d2..672a9e7c5e49 100644
--- a/ghc/docs/users_guide/how_to_run.lit
+++ b/ghc/docs/users_guide/how_to_run.lit
@@ -717,9 +717,23 @@ Options other than the above can be forced through to the C
pre-processor with the \tr{-opt} flags (see
\sectionref{forcing-options-through}).
-A small word of warning: \tr{-cpp} is not friendly to
-``string gaps''.\index{-cpp vs string gaps}\index{string gaps vs -cpp}
+A small word of warning: \tr{-cpp} is not friendly to ``string
+gaps''.\index{-cpp vs string gaps}\index{string gaps vs -cpp}. In
+other words, strings such as the following:
+\begin{verbatim}
+ strmod = "\
+ \ p \
+ \ "
+\end{verbatim}
+
+don't work with \tr{-cpp}; \tr{/usr/bin/cpp} elides the
+backslash-newline pairs.
+
+However, it appears that if you add a space at the end of the line,
+then \tr{cpp} (at least GNU \tr{cpp} and possibly other \tr{cpp}s)
+leaves the backslash-space pairs alone and the string gap works as
+expected.
%************************************************************************
%* *
--
GitLab