summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthew Pickering <matthewtpickering@gmail.com>2020-11-23 10:30:57 +0000
committerMatthew Pickering <matthewtpickering@gmail.com>2021-03-03 19:11:06 +0000
commit91d09039a8d6665097c1aa12f6fb3e6e45d4acca (patch)
treef27c46a539d6af2e1c9da3e064fd210e0f9cb7ca
parentdb80a5cc239d7d2a9c6f5259a782b99f8a4d8e41 (diff)
downloadhaskell-91d09039a8d6665097c1aa12f6fb3e6e45d4acca.tar.gz
Add release notes for -hi, -finfo-table-map and -fdistinct-constructor-tables
-rw-r--r--docs/users_guide/9.2.1-notes.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/users_guide/9.2.1-notes.rst b/docs/users_guide/9.2.1-notes.rst
index 2630ae91fe..c590a89d31 100644
--- a/docs/users_guide/9.2.1-notes.rst
+++ b/docs/users_guide/9.2.1-notes.rst
@@ -99,6 +99,12 @@ Compiler
There is a new RTS flag :rts-flag:`--no-automatic-heap-samples` which can be
used to stop heap profiling starting when a program starts.
+- A new debugging facility, :ghc-flag:`-finfo-table-map`, which embeds a mapping
+ from the address of an info table to information about that info table, including
+ an approximate source position. :ghc-flag:`-fdistinct-constructor-tables` is
+ also useful with this flag to give each usage of a data constructor its own
+ unique info table so they can be distinguished in gdb and heap profiles.
+
GHCi
~~~~
@@ -126,6 +132,14 @@ Runtime system
included in heap profiles. Tooling can choose to filter out these closure types
` if necessary.
+- A new heap profiling mode, :rts-flag:`-hi`, profile by info table allows for
+ fine-grain banding by the info table address of a closure. The profiling
+ mode is intended to be used with :ghc-flag:`-finfo-table-map` and can best
+ be consumed with ``eventlog2html``. This profiling mode does not require a
+ profiling build.
+
+``ghc-prim`` library
+~~~~~~~~~~~~~~~~~~~~
- ``Void#`` is now a type synonym for the unboxed tuple ``(# #)``.
Code using ``Void#`` now has to enable :extension:`UnboxedTuples`.