diff --git a/ghc/docs/users_guide/how_to_run.lit b/ghc/docs/users_guide/how_to_run.lit index 52617eff60d243ffc70ed759df820deef1090357..672a9e7c5e498572bf60342bea2fda1b37d361df 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. %************************************************************************ %* *