Docs: -keep-llvm-file(s)/-ddump-llvm imply -fllvm
authorThomas Miedema <thomasmiedema@gmail.com>
Mon, 22 Feb 2016 13:31:40 +0000 (14:31 +0100)
committerThomas Miedema <thomasmiedema@gmail.com>
Mon, 22 Feb 2016 13:32:40 +0000 (14:32 +0100)
This fixes #9917.

docs/users_guide/debugging.rst
docs/users_guide/separate_compilation.rst
utils/mkUserGuidePart/Options/CompilerDebugging.hs
utils/mkUserGuidePart/Options/KeepingIntermediates.hs

index a7bbbb5..a4e2d23 100644 (file)
@@ -144,6 +144,8 @@ Dumping out compiler intermediate structures
 
     .. ghc-flag:: -ddump-llvm
 
+        :implies: :ghc-flag:`-fllvm`
+
         LLVM code from the :ref:`LLVM code generator <llvm-code-gen>`
 
     .. ghc-flag:: -ddump-bcos
index afdde83..a2ce5eb 100644 (file)
@@ -334,12 +334,16 @@ The following options are useful for keeping certain intermediate files
 around, when normally GHC would throw these away after compilation:
 
 .. ghc-flag:: -keep-hc-file
+              -keep-hc-files
 
     Keep intermediate ``.hc`` files when doing ``.hs``-to-``.o``
     compilations via :ref:`C <c-code-gen>` (Note: ``.hc`` files are only
     generated by :ref:`unregisterised <unreg>` compilers).
 
 .. ghc-flag:: -keep-llvm-file
+              -keep-llvm-files
+
+    :implies: :ghc-flag:`-fllvm`
 
     Keep intermediate ``.ll`` files when doing ``.hs``-to-``.o``
     compilations via :ref:`LLVM <llvm-code-gen>` (Note: ``.ll`` files
@@ -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).
 
 .. ghc-flag:: -keep-s-file
+              -keep-s-files
 
     Keep intermediate ``.s`` files.
 
index 6160f01..3f1d899 100644 (file)
@@ -55,7 +55,8 @@ compilerDebuggingOptions =
          , flagType = DynamicFlag
          }
   , flag { flagName = "-ddump-llvm"
-         , flagDescription = "Dump LLVM intermediate code"
+         , flagDescription = "Dump LLVM intermediate code. "++
+           "Implies :ghc-flag:`-fllvm`."
          , flagType = DynamicFlag
          }
   , flag { flagName = "-ddump-occur-anal"
index 9c93aed..dd68de4 100644 (file)
@@ -5,19 +5,20 @@ import Types
 keepingIntermediatesOptions :: [Flag]
 keepingIntermediatesOptions =
   [ flag { flagName = "-keep-hc-file, -keep-hc-files"
-         , flagDescription = "retain intermediate ``.hc`` files"
+         , flagDescription = "Retain intermediate ``.hc`` files."
          , flagType = DynamicFlag
          }
   , 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
          }
   , flag { flagName = "-keep-s-file, -keep-s-files"
-         , flagDescription = "retain intermediate ``.s`` files"
+         , flagDescription = "Retain intermediate ``.s`` files."
          , flagType = DynamicFlag
          }
   , flag { flagName = "-keep-tmp-files"
-         , flagDescription = "retain all intermediate temporary files"
+         , flagDescription = "Retain all intermediate temporary files."
          , flagType = DynamicFlag
          }
   ]