From: simonmar Date: Wed, 5 May 2004 14:32:01 +0000 (+0000) Subject: [project @ 2004-05-05 14:32:01 by simonmar] X-Git-Tag: Initial_conversion_from_CVS_complete~1872 X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=7b91721eaddee0fb6dca07ee835aafa9228c25e9;p=ghc-hetmet.git [project @ 2004-05-05 14:32:01 by simonmar] Rearrange the -F/-pgmF documentation a bit. --- diff --git a/ghc/docs/users_guide/phases.sgml b/ghc/docs/users_guide/phases.sgml index ebbdf64..39e4ea4 100644 --- a/ghc/docs/users_guide/phases.sgml +++ b/ghc/docs/users_guide/phases.sgml @@ -375,44 +375,39 @@ strmod = "\ A custom pre-processor is run over your Haskell source file only if the option - -F is given. - - - Running a custom pre-processor at compile-time is in some - settings appropriate and useful. The - option lets you run a pre-processor as part of the overall - GHC compilation pipeline, which has the advantage over - running a Haskell pre-processor separately in that it - works in interpreted mode and you can continue to take - reap the benefits of GHC's recompilation checker. - - - The pre-processor is run just before the Haskell - compiler proper processes the Haskell input, but after - the literate markup has been stripped away and (possibly) - the C pre-processor has washed the Haskell input. - - - - - cmd - cmd - - Use cmd as the Haskell - pre-processor. When invoked, the - cmd pre-processor is given at - least three arguments on its command-line: the first - argument is the name of the original source file, the second - is the name of the file holding the input, and the third is - the name of the file where - cmd should write its output to. - - Additional arguments to the - cmd pre-processor can be passed - in using the option. These are fed to - cmd on the command line after the - three standard input and output arguments. - + -F is + given. + + Running a custom pre-processor at compile-time is in + some settings appropriate and useful. The + option lets you run a pre-processor as + part of the overall GHC compilation pipeline, which has + the advantage over running a Haskell pre-processor + separately in that it works in interpreted mode and you + can continue to take reap the benefits of GHC's + recompilation checker. + + The pre-processor is run just before the Haskell + compiler proper processes the Haskell input, but after the + literate markup has been stripped away and (possibly) the + C pre-processor has washed the Haskell input. + + Use + + to select the program to use as the preprocessor. When + invoked, the cmd pre-processor + is given at least three arguments on its command-line: the + first argument is the name of the original source file, + the second is the name of the file holding the input, and + the third is the name of the file where + cmd should write its output + to. + + Additional arguments to the pre-processor can be + passed in using the option. These + are fed to cmd on the command + line after the three standard input and output + arguments.