summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorroland <rsx@bluewin.ch>2018-08-21 12:18:26 -0400
committerBen Gamari <ben@smart-cactus.org>2018-08-21 18:52:42 -0400
commitebcbfba7bbf07fa9fbb78b46951892997795bcb8 (patch)
treee86c442edbcc6403bb7a2bf85c12b889f941ef39 /docs
parent23774c98f1368b41515cbd5223b87ea6dbf644e1 (diff)
downloadhaskell-ebcbfba7bbf07fa9fbb78b46951892997795bcb8.tar.gz
Introduce flag -keep-hscpp-files
Test Plan: `make test=T10869` Reviewers: mpickering, thomie, ezyang, bgamari Reviewed By: thomie, bgamari Subscribers: rwbarton, carter GHC Trac Issues: #10869 Differential Revision: https://phabricator.haskell.org/D4861
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/8.8.1-notes.rst1
-rw-r--r--docs/users_guide/separate_compilation.rst13
2 files changed, 14 insertions, 0 deletions
diff --git a/docs/users_guide/8.8.1-notes.rst b/docs/users_guide/8.8.1-notes.rst
index 2661b330ed..7ea2c87cbe 100644
--- a/docs/users_guide/8.8.1-notes.rst
+++ b/docs/users_guide/8.8.1-notes.rst
@@ -30,6 +30,7 @@ Language
Compiler
~~~~~~~~
+- New :ghc-flag:`-keep-hscpp-files` to keep the output of the CPP pre-processor.
Runtime system
~~~~~~~~~~~~~~
diff --git a/docs/users_guide/separate_compilation.rst b/docs/users_guide/separate_compilation.rst
index 613e4de191..d17ed2111c 100644
--- a/docs/users_guide/separate_compilation.rst
+++ b/docs/users_guide/separate_compilation.rst
@@ -397,6 +397,19 @@ compilation:
Keep intermediate ``.hi`` files. This is the default. You may use
``-no-keep-hi-files`` if you are not interested in the ``.hi`` files.
+.. ghc-flag:: -keep-hscpp-file
+ -keep-hscpp-files
+ :shortdesc: Retain intermediate ``.hscpp`` files.
+ :type: dynamic
+ :category: keep-intermediates
+
+ .. index::
+ single: temporary files; keeping
+
+ Keep the output of the ``CPP`` pre-processor phase as ``.hscpp`` files.
+ A ``.hscpp`` file is only created, if a module gets compiled and uses the
+ C pre-processor.
+
.. ghc-flag:: -keep-llvm-file
-keep-llvm-files
:shortdesc: Retain intermediate LLVM ``.ll`` files.