diff options
author | Takenobu Tani <takenobu.hs@gmail.com> | 2019-10-27 17:16:35 +0900 |
---|---|---|
committer | Marge Bot <ben+marge-bot@smart-cactus.org> | 2019-10-29 03:45:41 -0400 |
commit | 35abbfee8b4298ef7352a3c2341595c774a7244b (patch) | |
tree | 641356fc71ac7d4612b35e5cc6da4756a2972f97 /docs | |
parent | fb4f245cf5f38cf22fc8a3f81505b79acdba4ea5 (diff) | |
download | haskell-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]
Diffstat (limited to 'docs')
-rw-r--r-- | docs/users_guide/8.10.1-notes.rst | 12 | ||||
-rw-r--r-- | docs/users_guide/eventlog-formats.rst | 14 |
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) |