summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTakenobu Tani <takenobu.hs@gmail.com>2019-10-27 17:16:35 +0900
committerMarge Bot <ben+marge-bot@smart-cactus.org>2019-10-29 03:45:41 -0400
commit35abbfee8b4298ef7352a3c2341595c774a7244b (patch)
tree641356fc71ac7d4612b35e5cc6da4756a2972f97
parentfb4f245cf5f38cf22fc8a3f81505b79acdba4ea5 (diff)
downloadhaskell-35abbfee8b4298ef7352a3c2341595c774a7244b.tar.gz
users-guide: Add some new features and fix warnings for GHC 8.10
This updates the following: * Add description for ImportQualifiedPost extension * Add description for ghci command name resolution * Fix markdown warnings [skip ci]
-rw-r--r--docs/users_guide/8.10.1-notes.rst12
-rw-r--r--docs/users_guide/eventlog-formats.rst14
2 files changed, 17 insertions, 9 deletions
diff --git a/docs/users_guide/8.10.1-notes.rst b/docs/users_guide/8.10.1-notes.rst
index 9ead1bb017..911e123c59 100644
--- a/docs/users_guide/8.10.1-notes.rst
+++ b/docs/users_guide/8.10.1-notes.rst
@@ -104,6 +104,11 @@ Language
for a ``newtype``. This was proposed in
`GHC proposal #13 <https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0013-unlifted-newtypes.rst>`__.
+- A new extension :extension:`ImportQualifiedPost` allows the syntax
+ ``import M qualified``, that is, to annotate a module as qualified by
+ writing ``qualified`` after the module name.
+ This was proposed in `GHC proposal #49 <https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0049-module-qualified-syntax.rst>`__.
+
- New flag :ghc-flag:`-Wderiving-defaults` that controls a warning
message when both :extension:`DeriveAnyClass` and
:extension:`GeneralizedNewtypeDeriving` are enabled and no explicit
@@ -167,7 +172,7 @@ Compiler
The retainer profiling events are emitted using the standard events.
- The eventlog now logs the cost centre stack on each sample. This enables
- the `.prof` file to be partially reconstructed from the eventlog.
+ the ``.prof`` file to be partially reconstructed from the eventlog.
- Add new flag :ghc-flag:`-fkeep-going` which makes the compiler
continue as far as it can despite errors.
@@ -194,6 +199,9 @@ GHCi
- Added new debugger commands :ghci-cmd:`:disable` and :ghci-cmd:`:enable` to
disable and re-enable breakpoints.
+- Improved command name resolution with option ``!``. For example, ``:k!``
+ resolves to ``:kind!``.
+
Runtime system
~~~~~~~~~~~~~~
@@ -206,7 +214,7 @@ Template Haskell
:extension:`DeriveLift` has been simplified to take advantage of expression
quotations.
-- Explicit boxed 1-tuples from `HsSyn` are now treated as actual 1-tuples,
+- Explicit boxed 1-tuples from ``HsSyn`` are now treated as actual 1-tuples,
without flattening. In most of the cases these will be obtained using
Template Haskell since it is uncommon to deal with 1-tuples in the source.
diff --git a/docs/users_guide/eventlog-formats.rst b/docs/users_guide/eventlog-formats.rst
index a3ed47fc3c..2f418b836a 100644
--- a/docs/users_guide/eventlog-formats.rst
+++ b/docs/users_guide/eventlog-formats.rst
@@ -146,7 +146,7 @@ on each tick the current cost centre stack is emitted. Together these enable
a user to construct an approximate track of the executation of their program.
Profile begin event
-^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~
* ``EVENT_PROF_BEGIN``
@@ -154,13 +154,13 @@ Profile begin event
Tick sample event
-^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~
A variable-length packet encoding a profile sample.
-* ``EVENT_PROF_SAMPLE_COST_CENTRE``
+ * ``EVENT_PROF_SAMPLE_COST_CENTRE``
- * ``Word32``: Capability
- * ``Word64``: Current profiling tick
- * ``Word8``: stack depth
- * ``Word32[]``: cost centre stack starting with inner-most (cost centre numbers)
+ * ``Word32``: Capability
+ * ``Word64``: Current profiling tick
+ * ``Word8``: stack depth
+ * ``Word32[]``: cost centre stack starting with inner-most (cost centre numbers)