Document -fllvm-fill-undef-with-garbage
authorBen Gamari <ben@smart-cactus.org>
Wed, 27 Jan 2016 11:24:48 +0000 (12:24 +0100)
committerBen Gamari <ben@smart-cactus.org>
Wed, 27 Jan 2016 11:24:48 +0000 (12:24 +0100)
docs/users_guide/debugging.rst

index 80c9f8d..a7bbbb5 100644 (file)
@@ -333,6 +333,12 @@ Checking for consistency
 
     Ditto for C-- level.
 
+.. ghc-flag:: -fllvm-fill-undef-with-garbage
+
+    Instructs the LLVM code generator to fill dead STG registers with garbage
+    instead of ``undef`` in calls. This makes it easier to catch subtle
+    code generator and runtime system bugs (e.g. see :ghc-ticket:`11487`).
+
 .. _checking-determinism:
 
 Checking for determinism