Commit ed119096 authored by thomie's avatar thomie

Docs: -keep-llvm-file(s)/-ddump-llvm imply -fllvm

This fixes #9917.
parent bb9cd454
...@@ -144,6 +144,8 @@ Dumping out compiler intermediate structures ...@@ -144,6 +144,8 @@ Dumping out compiler intermediate structures
.. ghc-flag:: -ddump-llvm .. ghc-flag:: -ddump-llvm
:implies: :ghc-flag:`-fllvm`
LLVM code from the :ref:`LLVM code generator <llvm-code-gen>` LLVM code from the :ref:`LLVM code generator <llvm-code-gen>`
.. ghc-flag:: -ddump-bcos .. ghc-flag:: -ddump-bcos
......
...@@ -334,12 +334,16 @@ The following options are useful for keeping certain intermediate files ...@@ -334,12 +334,16 @@ The following options are useful for keeping certain intermediate files
around, when normally GHC would throw these away after compilation: around, when normally GHC would throw these away after compilation:
.. ghc-flag:: -keep-hc-file .. ghc-flag:: -keep-hc-file
-keep-hc-files
Keep intermediate ``.hc`` files when doing ``.hs``-to-``.o`` Keep intermediate ``.hc`` files when doing ``.hs``-to-``.o``
compilations via :ref:`C <c-code-gen>` (Note: ``.hc`` files are only compilations via :ref:`C <c-code-gen>` (Note: ``.hc`` files are only
generated by :ref:`unregisterised <unreg>` compilers). generated by :ref:`unregisterised <unreg>` compilers).
.. ghc-flag:: -keep-llvm-file .. ghc-flag:: -keep-llvm-file
-keep-llvm-files
:implies: :ghc-flag:`-fllvm`
Keep intermediate ``.ll`` files when doing ``.hs``-to-``.o`` Keep intermediate ``.ll`` files when doing ``.hs``-to-``.o``
compilations via :ref:`LLVM <llvm-code-gen>` (Note: ``.ll`` files compilations via :ref:`LLVM <llvm-code-gen>` (Note: ``.ll`` files
...@@ -347,6 +351,7 @@ around, when normally GHC would throw these away after compilation: ...@@ -347,6 +351,7 @@ around, when normally GHC would throw these away after compilation:
to use :ghc-flag:`-fllvm` to force them to be produced). to use :ghc-flag:`-fllvm` to force them to be produced).
.. ghc-flag:: -keep-s-file .. ghc-flag:: -keep-s-file
-keep-s-files
Keep intermediate ``.s`` files. Keep intermediate ``.s`` files.
......
...@@ -55,7 +55,8 @@ compilerDebuggingOptions = ...@@ -55,7 +55,8 @@ compilerDebuggingOptions =
, flagType = DynamicFlag , flagType = DynamicFlag
} }
, flag { flagName = "-ddump-llvm" , flag { flagName = "-ddump-llvm"
, flagDescription = "Dump LLVM intermediate code" , flagDescription = "Dump LLVM intermediate code. "++
"Implies :ghc-flag:`-fllvm`."
, flagType = DynamicFlag , flagType = DynamicFlag
} }
, flag { flagName = "-ddump-occur-anal" , flag { flagName = "-ddump-occur-anal"
......
...@@ -5,19 +5,20 @@ import Types ...@@ -5,19 +5,20 @@ import Types
keepingIntermediatesOptions :: [Flag] keepingIntermediatesOptions :: [Flag]
keepingIntermediatesOptions = keepingIntermediatesOptions =
[ flag { flagName = "-keep-hc-file, -keep-hc-files" [ flag { flagName = "-keep-hc-file, -keep-hc-files"
, flagDescription = "retain intermediate ``.hc`` files" , flagDescription = "Retain intermediate ``.hc`` files."
, flagType = DynamicFlag , flagType = DynamicFlag
} }
, flag { flagName = "-keep-llvm-file, -keep-llvm-files" , flag { flagName = "-keep-llvm-file, -keep-llvm-files"
, flagDescription = "retain intermediate LLVM ``.ll`` files" , flagDescription = "Retain intermediate LLVM ``.ll`` files. "++
"Implies :ghc-flag:`-fllvm`."
, flagType = DynamicFlag , flagType = DynamicFlag
} }
, flag { flagName = "-keep-s-file, -keep-s-files" , flag { flagName = "-keep-s-file, -keep-s-files"
, flagDescription = "retain intermediate ``.s`` files" , flagDescription = "Retain intermediate ``.s`` files."
, flagType = DynamicFlag , flagType = DynamicFlag
} }
, flag { flagName = "-keep-tmp-files" , flag { flagName = "-keep-tmp-files"
, flagDescription = "retain all intermediate temporary files" , flagDescription = "Retain all intermediate temporary files."
, flagType = DynamicFlag , flagType = DynamicFlag
} }
] ]
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment