Data.Either: Add fromLeft and fromRight (#12402)
[ghc.git] / docs / users_guide / 8.2.1-notes.rst
1 .. _release-8-2-1:
2
3 Release notes for version 8.2.1
4 ===============================
5
6 The significant changes to the various parts of the compiler are listed
7 in the following sections. There have also been numerous bug fixes and
8 performance improvements over the 8.0 branch.
9
10 Highlights
11 ----------
12
13 The highlights since the 8.0 branch are:
14
15 - TODO FIXME
16 - SCC annotations can now be used for declarations.
17
18 Full details
19 ------------
20
21 Language
22 ~~~~~~~~
23
24 -  TODO FIXME.
25
26 - Pattern synonym signatures can now be applied to multiple patterns, just like
27   value-level binding signatures. See :ref:`patsyn-typing` for details.
28
29 Compiler
30 ~~~~~~~~
31
32 -  TODO FIXME.
33
34 - Old profiling flags ``-auto-all``, ``-auto``, and ``-caf-all`` are deprecated
35   and their usage provokes a compile-time warning.
36
37 - Support for adding cost centres to declarations is added. The same `SCC`
38   syntax can be used, in addition to a new form for specifying the cost centre
39   name. See :ref:`scc-pragma` for examples.
40
41 GHCi
42 ~~~~
43
44 -  TODO FIXME.
45
46 Template Haskell
47 ~~~~~~~~~~~~~~~~
48
49 -  TODO FIXME.
50
51 - ``addModFinalizer`` now exposes the local typing environment at the splice
52   point. This allows ``reify`` to see local and top-level definitions in the
53   current declaration group when used as in
54
55   .. code-block:: none
56
57       f x = $(addModFinalizer (reify 'x >>= runIO . print) >> [| x |])
58
59 Runtime system
60 ~~~~~~~~~~~~~~
61
62 -  TODO FIXME.
63
64 - The :ref:`heap profiler <prof-heap>` can now emit heap census data to the GHC
65   event log, allowing heap profiles to be correlated with other tracing events
66   (see :ghc-ticket:`11094`).
67
68 Build system
69 ~~~~~~~~~~~~
70
71 -  TODO FIXME.
72
73 Package system
74 ~~~~~~~~~~~~~~
75
76 -  TODO FIXME.
77
78 hsc2hs
79 ~~~~~~
80
81 -  TODO FIXME.
82
83 Libraries
84 ---------
85
86 array
87 ~~~~~
88
89 -  Version number XXXXX (was 0.5.0.0)
90
91
92 .. _lib-base:
93
94 base
95 ~~~~
96
97 See ``changelog.md`` in the ``base`` package for full release notes.
98
99 -  Version number 4.10.0.0 (was 4.9.0.0)
100
101 - ``Data.Either`` now provides ``fromLeft`` and ``fromRight``
102
103 binary
104 ~~~~~~
105
106 -  Version number XXXXX (was 0.7.1.0)
107
108 bytestring
109 ~~~~~~~~~~
110
111 -  Version number XXXXX (was 0.10.4.0)
112
113 Cabal
114 ~~~~~
115
116 -  Version number XXXXX (was 1.18.1.3)
117
118 containers
119 ~~~~~~~~~~
120
121 -  Version number XXXXX (was 0.5.4.0)
122
123 deepseq
124 ~~~~~~~
125
126 -  Version number XXXXX (was 1.3.0.2)
127
128 directory
129 ~~~~~~~~~
130
131 -  Version number XXXXX (was 1.2.0.2)
132
133 filepath
134 ~~~~~~~~
135
136 -  Version number XXXXX (was 1.3.0.2)
137
138 ghc
139 ~~~
140
141 -  TODO FIXME.
142
143 ghc-boot
144 ~~~~~~~~
145
146 -  This is an internal package. Use with caution.
147
148 -  TODO FIXME.
149
150 ghc-prim
151 ~~~~~~~~
152
153 -  Version number XXXXX (was 0.3.1.0)
154
155 -  Added new ``isByteArrayPinned#`` and ``isMutableByteArrayPinned#`` operation.
156
157 haskell98
158 ~~~~~~~~~
159
160 -  Version number XXXXX (was 2.0.0.3)
161
162 haskell2010
163 ~~~~~~~~~~~
164
165 -  Version number XXXXX (was 1.1.1.1)
166
167 hoopl
168 ~~~~~
169
170 -  Version number XXXXX (was 3.10.0.0)
171
172 hpc
173 ~~~
174
175 -  Version number XXXXX (was 0.6.0.1)
176
177 integer-gmp
178 ~~~~~~~~~~~
179
180 -  Version number XXXXX (was 0.5.1.0)
181
182 old-locale
183 ~~~~~~~~~~
184
185 -  Version number XXXXX (was 1.0.0.6)
186
187 old-time
188 ~~~~~~~~
189
190 -  Version number XXXXX (was 1.1.0.2)
191
192 process
193 ~~~~~~~
194
195 -  Version number XXXXX (was 1.2.0.0)
196
197 template-haskell
198 ~~~~~~~~~~~~~~~~
199
200 -  Version number XXXXX (was 2.9.0.0)
201
202 time
203 ~~~~
204
205 -  Version number XXXXX (was 1.4.1)
206
207 unix
208 ~~~~
209
210 -  Version number XXXXX (was 2.7.0.0)
211
212 Win32
213 ~~~~~
214
215 -  Version number XXXXX (was 2.3.0.1)
216
217 Known bugs
218 ----------
219
220 -  TODO FIXME