summaryrefslogtreecommitdiff
path: root/docs/users_guide/phases.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/users_guide/phases.rst')
-rw-r--r--docs/users_guide/phases.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/users_guide/phases.rst b/docs/users_guide/phases.rst
index 8b99939d98..c931268bbd 100644
--- a/docs/users_guide/phases.rst
+++ b/docs/users_guide/phases.rst
@@ -1322,3 +1322,17 @@ for example).
that do runtime dynamic linking, where code dynamically linked in
the future might require the value of a CAF that would otherwise
be garbage-collected.
+
+.. ghc-flag:: -fcompact-unwind
+ :shortdesc: Instruct the linker to produce a `__compact_unwind` section.
+ :type: dynamic
+ :category: linking
+
+ :since: 9.4.1
+
+ This instructs the linker to produce an executable that supports Apple's
+ compact unwinding sections. These are used by C++ and Objective-C code
+ to unwind the stack when an exception occurs.
+
+ In theory, the older `__eh_frame` section should also be usable for this
+ purpose, but this does not always work.