summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKrzysztof Gogolewski <krzysztof.gogolewski@tweag.io>2023-04-21 11:37:42 +0200
committerMarge Bot <ben+marge-bot@smart-cactus.org>2023-05-12 06:11:38 -0400
commitab63daac0e0ed8749514e38d714cfcd4562f4326 (patch)
treea8914398a67f2be5a8025a3949fee98ed0e5685c /docs
parentc176ad1835ccfe55e2bde875b4a35e9d226ff657 (diff)
downloadhaskell-ab63daac0e0ed8749514e38d714cfcd4562f4326.tar.gz
Allow Core optimizations when interpreting bytecode
Tracking ticket: #23056 MR: !10399 This adds the flag `-funoptimized-core-for-interpreter`, permitting use of the `-O` flag to enable optimizations when compiling with the interpreter backend, like in ghci.
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/debugging.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/users_guide/debugging.rst b/docs/users_guide/debugging.rst
index e2acac340f..04bb5ca97a 100644
--- a/docs/users_guide/debugging.rst
+++ b/docs/users_guide/debugging.rst
@@ -1146,3 +1146,17 @@ Other
be terminated. This helps narrowing down if an issue is due to tag inference
if things go wrong. Which would otherwise be quite difficult.
+.. ghc-flag:: -funoptimized-core-for-interpreter
+ :shortdesc: Disable optimizations with the interpreter
+ :reverse: -fno-unoptimized-core-for-interpreter
+ :type: dynamic
+
+ :since: 9.8.1
+
+ default: enabled
+
+ At the moment, ghci disables optimizations, because not all passes
+ are compatible with the interpreter.
+ This option can be used to override this check, e.g.
+ ``ghci -O2 -fno-unoptimized-core-for-interpreter``.
+ It is not recommended for normal use and can cause a compiler panic.