summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKai Harries <kai.harries@gmail.com>2016-03-24 22:33:27 +0100
committerBen Gamari <ben@smart-cactus.org>2016-03-24 23:15:16 +0100
commit24149528a0a2d17ff9b5b087e0a8249c8c9cef98 (patch)
tree9feef1475b49a01a81e7767f81816494f5d06bbe /docs
parent173a5d8ee4d3d8b7ddd2e8b81c957d03441c4f2b (diff)
downloadhaskell-24149528a0a2d17ff9b5b087e0a8249c8c9cef98.tar.gz
Add option `no-keep-hi-files` and `no-keep-o-files` (fixes #4114)
Summary: Remove `.hi` and `.o` files if the flags `no-keep-hi-files` and `no-keep-o-files` are given. Test Plan: ./validate Reviewers: austin, thomie, bgamari Reviewed By: thomie, bgamari Subscribers: thomie Differential Revision: https://phabricator.haskell.org/D2021 GHC Trac Issues: #4114
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/separate_compilation.rst21
1 files changed, 19 insertions, 2 deletions
diff --git a/docs/users_guide/separate_compilation.rst b/docs/users_guide/separate_compilation.rst
index a2ce5ebd50..c0d42e9c24 100644
--- a/docs/users_guide/separate_compilation.rst
+++ b/docs/users_guide/separate_compilation.rst
@@ -330,8 +330,9 @@ Keeping Intermediate Files
single: .ll files, saving
single: .s files, saving
-The following options are useful for keeping certain intermediate files
-around, when normally GHC would throw these away after compilation:
+The following options are useful for keeping (or not keeping) certain
+intermediate files around, when normally GHC would throw these away after
+compilation:
.. ghc-flag:: -keep-hc-file
-keep-hc-files
@@ -340,6 +341,14 @@ around, when normally GHC would throw these away after compilation:
compilations via :ref:`C <c-code-gen>` (Note: ``.hc`` files are only
generated by :ref:`unregisterised <unreg>` compilers).
+.. ghc-flag:: -keep-hi-files
+
+ .. index::
+ single: temporary files; keeping
+
+ 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-llvm-file
-keep-llvm-files
@@ -350,6 +359,14 @@ around, when normally GHC would throw these away after compilation:
aren't generated when using the native code generator, you may need
to use :ghc-flag:`-fllvm` to force them to be produced).
+.. ghc-flag:: -keep-o-files
+
+ .. index::
+ single: temporary files; keeping
+
+ Keep intermediate ``.o`` files. This is the default. You may use
+ ``-no-keep-o-files`` if you are not interested in the ``.o`` files.
+
.. ghc-flag:: -keep-s-file
-keep-s-files