1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
|
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
<header>
<copyright>
<year>2006</year><year>2016</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
</legalnotice>
<title>Dialyzer Release Notes</title>
<prepared>otp_appnotes</prepared>
<docno>nil</docno>
<date>nil</date>
<rev>nil</rev>
<file>notes.xml</file>
</header>
<p>This document describes the changes made to the Dialyzer
application.</p>
<section><title>Dialyzer 3.1.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Report unknown types properly. A bug was introduced
in Erlang/OTP 19.3, where warnings about unknown types
were simply discarded. </p>
<p>
Own Id: OTP-14368</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 3.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Fix a bug concerning parameterized opaque types. </p>
<p>
Own Id: OTP-14130</p>
</item>
<item>
<p> Improve a few warnings. One of them could cause a
crash. </p>
<p>
Own Id: OTP-14177</p>
</item>
<item>
<p>The dialyzer and observer applications will now use a
portable way to find the home directory. That means that
there is no longer any need to manually set the HOME
environment variable on Windows.</p>
<p>
Own Id: OTP-14249 Aux Id: ERL-161 </p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The peak memory consumption is reduced. </p><p> The
evaluation of huge SCCs in <c>dialyzer_typesig</c> is
optimized. </p><p> Analyzing modules with binary
construction with huge strings is now much faster. </p>
<p>
Own Id: OTP-14126 Aux Id: ERL-308 </p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 3.0.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Fix bugs regarding opaque types. </p>
<p>
Own Id: OTP-13693</p>
</item>
<item>
<p> Fix error handling of bad <c>-dialyzer()</c>
attributes. </p>
<p>
Own Id: OTP-13979 Aux Id: ERL-283 </p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> A few warning messages have been improved. </p>
<p>
Own Id: OTP-11403</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 3.0.2</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The translation of forms to types is improved for
opaque types in a few cases. </p>
<p>
Own Id: OTP-13682</p>
</item>
<item>
<p> Add warning suppression to compiler-generated case
statements. Warnings about clauses that cannot match and
are also compiler generated are suppressed unless none of
the clauses return. </p>
<p>
Own Id: OTP-13723 Aux Id: ERL-159, PR-1121 </p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 3.0.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>Fix a map related bug.</p>
<p>
Own Id: OTP-13709 Aux Id: ERL-177, PR-1115 </p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 3.0</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Fix a bug in the translation of forms to types. </p>
<p>
Own Id: OTP-13520</p>
</item>
<item>
<p>Correct misspelling in Dialyzer's acronym definition.
</p>
<p>
Own Id: OTP-13544 Aux Id: PR-1007 </p>
</item>
<item>
<p>Dialyzer no longer crashes when there is an invalid
function call such as <c>42(7)</c> in a module being
analyzed. The compiler will now warn for invalid function
calls such as <c>X = 42, x(7)</c>.</p>
<p>
Own Id: OTP-13552 Aux Id: ERL-138 </p>
</item>
<item>
<p> Fix a bug that caused Dialyzer to go into an infinite
loop. </p>
<p>
Own Id: OTP-13653 Aux Id: ERL-157 </p>
</item>
<item>
<p>Fix a bug in Dialyzer related to call-site
analysis.</p>
<p>
Own Id: OTP-13655 Aux Id: PR-1092 </p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The evaluation of SCCs in <c>dialyzer_typesig</c> is
optimized. </p> <p> Maps are used instead of Dicts to
further optimize the evaluation. </p>
<p>
Own Id: OTP-10349</p>
</item>
<item>
<p> Since Erlang/OTP R14A, when support for parameterized
modules was added, <c>module()</c> has included
<c>tuple()</c>, but that part is removed; the type
<c>module()</c> is now the same as <c>atom()</c>, as
documented in the Reference Manual. </p>
<p>
Own Id: OTP-13244</p>
</item>
<item>
<p> The type specification syntax for Maps is improved:
</p> <list> <item> <p> The association type <c>KeyType :=
ValueType</c> denotes an association that must be
present. </p> </item> <item> <p> The shorthand <c>...</c>
stands for the association type <c>any() => any()</c>.
</p> </item> </list> <p> An incompatible change is that
<c>#{}</c> stands for the empty map. The type
<c>map()</c> (a map of any size) can be written as
<c>#{...}</c>. </p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-13542 Aux Id: PR-1014 </p>
</item>
<item>
<p>The translation of forms to types is improved. </p>
<p>
Own Id: OTP-13547</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.9</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Dialyzer no longer asserts that files and directories
to be removed from a PLT exist. </p>
<p>
Own Id: OTP-13103 Aux Id: ERL-40 </p>
</item>
<item>
<p> Fix a bug concerning parameterized opaque types. </p>
<p>
Own Id: OTP-13237</p>
</item>
<item>
<p>
Fix pretty printing of Core Maps</p>
<p>
Literal maps could cause Dialyzer to crash when pretty
printing the results.</p>
<p>
Own Id: OTP-13238</p>
</item>
<item>
<p>
If a behavior module contains an non-exported function
with the same name as one of the behavior's callbacks,
the callback info was inadvertently deleted from the PLT
as the <c>dialyzer_plt:delete_list/2</c> function was
cleaning up the callback table.</p>
<p>
Own Id: OTP-13287</p>
</item>
<item>
<p> Correct the contract for <c>erlang:byte_size/1</c>
</p> <p> Correct the handling of comparison operators for
map and bit string operands. </p>
<p>
Own Id: OTP-13312</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Dialyzer recognizes calls to <c>M:F/A</c> where <c>M</c>,
<c>F</c>, and <c>A</c> are all literals.</p>
<p>
Own Id: OTP-13217</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.8.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Reintroduce the <c>erlang:make_fun/3</c> BIF in
erl_bif_types.</p>
<p>
Own Id: OTP-13068</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.8.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>Improve the translation of forms to types. </p>
<p>
Own Id: OTP-12865</p>
</item>
<item>
<p> Fix a bug concerning parameterized opaque types. </p>
<p>
Own Id: OTP-12866</p>
</item>
<item>
<p> Fix a bug concerning parameterized opaque types. </p>
<p>
Own Id: OTP-12940</p>
</item>
<item>
<p> Fix bugs concerning <c>erlang:abs/1</c>. </p>
<p>
Own Id: OTP-12948</p>
</item>
<item>
<p> Fix a bug concerning <c>lists:keydelete/3</c> with
union and opaque types. </p>
<p>
Own Id: OTP-12949</p>
</item>
<item>
<p>
Use new function <c>hipe:erts_checksum</c> to get correct
runtime checksum for cached beam files.</p>
<p>
Own Id: OTP-12964 Aux Id: OTP-12963, OTP-12962 </p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.8</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> The translation of Erlang forms to the type
representation used by Dialyzer has been improved in
several ways. The most important change is that deeply
nested records can be handled. </p>
<p>
Own Id: OTP-12350</p>
</item>
<item>
<p> Fix a bug that could cause bogus warnings for opaque
types. </p> <p>In Erlang/OTP 18 two parameterized types
declared in the same module always result in a
contradiction (<c>none()</c>) when combined outside of
the module where they are declared, unless they have the
same number of parameters. </p> <p> The behaviour is
different from Erlang/OTP 17 where, for instance,
<c>dict:dict()</c> and <c>dict:dict(_, _)</c>, which are
both opaque, can be combined outside of the <c>dict</c>
module. </p> <p> In Erlang/OTP 18, <c>dict:dict()</c> and
<c>dict:dict(_, _)</c> can still be combined outside of
the <c>dict</c> module. That has been made possible by
not declaring <c>dict:dict()</c> as opaque. </p>
<p>
Own Id: OTP-12493</p>
</item>
<item>
<p> Update the PLT properly when a module is changed.
(Thanks to James Fish for the bug report, and to Stavros
Aronis for fixing the bug.) </p>
<p>
Own Id: OTP-12637</p>
</item>
<item>
<p>
An argument of '*'/2 is not constraind if the other
operand can be zero.</p>
<p>
Own Id: OTP-12725</p>
</item>
<item>
<p> Mention the option <c>check_plt</c> among the
<c>dialyzer:gui()</c> options. (Thanks to James Fish.)
</p>
<p>
Own Id: OTP-12750</p>
</item>
<item>
<p>Fix a bug which could cause an infinite loop in
Dialyzer.</p>
<p>
Own Id: OTP-12826</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The <c>-dialyzer()</c> attribute can be used for
suppressing warnings in a module by specifying functions
or warning options. It can also be used for requesting
warnings in a module. </p>
<p>
Own Id: OTP-10280</p>
</item>
<item>
<p> The pre-defined types <c>array()</c>, <c>dict()</c>,
<c>digraph()</c>, <c>gb_set()</c>, <c>gb_tree()</c>,
<c>queue()</c>, <c>set()</c>, and <c>tid()</c> have been
removed. </p>
<p>
Own Id: OTP-11445 Aux Id: OTP-10342, OTP-9352 </p>
</item>
<item>
<p> A few type names that have been used for representing
certain predefined types can now be used for user-defined
types. This affects the types <c>product/_</c>,
<c>union/_</c>, and <c>range/2</c> as well as
<c>tuple/N</c> (N > 0), <c>map/N</c> (N > 0),
<c>atom/1</c>, <c>integer/1</c>, <c>binary/2</c>,
<c>record/_,</c> and <c>'fun'/_</c>. A consequence is
that, for example, it is no longer possible to refer to a
record type with <c>record(r)</c>; instead the usual
record notation, <c>#r{}</c>, is to be used. </p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-11851</p>
</item>
<item>
<p> When implementing user-defined behaviours it is now
possible to specify optional callback functions. See OTP
Design Principles User's Guide, Sys and Proc_Lib,
User-Defined Behaviours, for details. </p>
<p>
Own Id: OTP-11861</p>
</item>
<item>
<p>Add two options to the Dialyzer:
<c>no_missing_calls</c> suppresses warnings about calls
to missing or unexported functions; <c>unknown</c> lets
warnings about unknown functions or types affect the exit
status. See also dialyzer(3). </p>
<p>
Own Id: OTP-12682</p>
</item>
<item>
<p>By default, dialyzer will now cache native versions of
dialyzer modules to avoid having to re-compile them each
time dialyzer is started. Caching can be disabled using
the option <c>--no_native_cache</c>.</p>
<p>
Own Id: OTP-12779</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.7.4</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> A bug concerning <c>map()</c> types has been fixed.
</p>
<p>
Own Id: OTP-12472</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.7.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> When compiling Erlang source, Dialyzer now ignores
the environment variable ERL_COMPILER_OPTIONS as well as
skips the Erlang Compiler option
<c>warnings_as_errors</c>. </p>
<p>
Own Id: OTP-12225</p>
</item>
<item>
<p> Dialyzer did not check the type of record elements
when updating them. The bug, introduced in Erlang/OTP
17.1, has been corrected. (Thanks to Nicolas Dudebout for
pointing it out.) </p>
<p>
Own Id: OTP-12319</p>
</item>
<item>
<p>
Coalesce map keys in dialyzer mode</p>
<p>
This fixes a regression introduced in commit
805f9c89fc01220bc1bb0f27e1b68fd4eca688ba The problem
occurred with compounded map keys compiled with dialyzer
option turned on, '+dialyzer'.</p>
<p>
Reported by: Ivan Uemlianin</p>
<p>
Own Id: OTP-12347</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.7.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> A bug concerning <c>is_record/2,3</c> has been fixed,
as well as some cases where Dialyzer could crash due to
reaching system limits. </p>
<p>
Own Id: OTP-12018</p>
</item>
<item>
<p> When given the <c>-Wunderspecs</c> flag Dialyzer
sometimes output bogus warnings for parametrized types.
This bug has been fixed. </p>
<p>
Own Id: OTP-12111</p>
</item>
<item>
<p>Dialyzer now fetch the compile options from beam
files, and use them when creating core from the abstract
code. Previously the options were ignored. </p>
<p>
Own Id: OTP-12150</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.7.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Fix a bug concerning opaque types. Thanks to Shayan
Pooya for pointing out the bug.</p>
<p>
Own Id: OTP-11869</p>
</item>
<item>
<p> A bug where Dialyzer failed to handle typed records
with fields containing remote types has been fixed.
Thanks to Erik Søe Sørensen for reporting the bug. </p>
<p>
Own Id: OTP-11918</p>
</item>
<item>
<p> Make sure that only literal records are checked
against the types of record definitions. Until now the
elements of tuples have been checked against record field
types if the tag och size of the tuple matches the record
definition, often with surprising results. </p>
<p>
Own Id: OTP-11935 Aux Id: seq12590 </p>
</item>
<item>
<p>
A Dialyzer crash involving analysis of Map types has now
been fixed.</p>
<p>
Own Id: OTP-11947</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.7</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Dialyzer will no longer emit warnings when inspecting
or modifying opaque types within the scope of a module.
</p> <p> Hitherto the shape of terms (tuple, list, etc.)
has been used to determine the opaque terms, but now the
contracts are used for decorating types with opacity.
</p>
<p>
Own Id: OTP-10397</p>
</item>
<item>
<p>
With <c>--Wunmatched_returns</c>, dialyzer will no longer
warn when the value of a list comprehension is ignored,
provided that the each value in the list would be an
atomic value (such as integer or atoms, as opposed to
tuples and lists). Example: ignoring '<c>[io:format(...)
|| ...]</c>' will not cause a warning, while ignoring
'<c>[file:close(Fd) || ...]</c>' will.</p>
<p>
Own Id: OTP-11626</p>
</item>
<item>
<p>
The man page for dialyzer now contains correct
information regarding -Wno_behaviours. (Thanks to Steve
Vinosky.)</p>
<p>
Own Id: OTP-11706</p>
</item>
<item>
<p> Fix handling of 'on_load' attribute. (Thanks to
Kostis Sagonas.) </p>
<p>
Own Id: OTP-11743</p>
</item>
<item>
<p>
Application upgrade (appup) files are corrected for the
following applications: </p>
<p>
<c>asn1, common_test, compiler, crypto, debugger,
dialyzer, edoc, eldap, erl_docgen, et, eunit, gs, hipe,
inets, observer, odbc, os_mon, otp_mibs, parsetools,
percept, public_key, reltool, runtime_tools, ssh,
syntax_tools, test_server, tools, typer, webtool, wx,
xmerl</c></p>
<p>
A new test utility for testing appup files is added to
test_server. This is now used by most applications in
OTP.</p>
<p>
(Thanks to Tobias Schlager)</p>
<p>
Own Id: OTP-11744</p>
</item>
<item>
<p> The generalization of guard constraints has been
modified. </p>
<p>
Own Id: OTP-11798 Aux Id: seq12547 </p>
</item>
<item>
<p> Dialyzer now plays nicely with funs that come as
"external" arguments. (Thanks to Stavros Aronis for
fixing the bug.) </p>
<p>
Own Id: OTP-11826</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The pre-defined types <c>array/0</c>, <c>dict/0</c>,
<c>digraph/0</c>, <c>gb_set/0</c>, <c>gb_tree/0</c>,
<c>queue/0</c>, <c>set/0</c>, and <c>tid/0</c> have been
deprecated. They will be removed in Erlang/OTP 18.0. </p>
<p> Instead the types <c>array:array/0</c>,
<c>dict:dict/0</c>, <c>digraph:graph/0</c>,
<c>gb_set:set/0</c>, <c>gb_tree:tree/0</c>,
<c>queue:queue/0</c>, <c>sets:set/0</c>, and
<c>ets:tid/0</c> can be used. (Note: it has always been
necessary to use <c>ets:tid/0</c>.) </p> <p> It is
allowed in Erlang/OTP 17.0 to locally re-define the types
<c>array/0</c>, <c>dict/0</c>, and so on. </p> <p> New
types <c>array:array/1</c>, <c>dict:dict/2</c>,
<c>gb_sets:set/1</c>, <c>gb_trees:tree/2</c>,
<c>queue:queue/1</c>, and <c>sets:set/1</c> have been
added. </p> <p> A compiler option,
<c>nowarn_deprecated_type</c>, has been introduced. By
including the attribute </p> <c>
-compile(nowarn_deprecated_type).</c> <p> in an Erlang
source file, warnings about deprecated types can be
avoided in Erlang/OTP 17.0. </p> <p> The option can also
be given as a compiler flag: </p> <c> erlc
+nowarn_deprecated_type file.erl</c>
<p>
Own Id: OTP-10342</p>
</item>
<item>
<p>
Removed gs based applications and gs based backends. The
<c>observer</c> application replaces the removed
applications.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-10915</p>
</item>
<item>
<p>
Forbid unsized fields in patterns of binary generators
and simplified v3_core's translation of bit string
generators. (Thanks to Anthony Ramine.)</p>
<p>
Own Id: OTP-11186</p>
</item>
<item>
<p>
EEP43: New data type - Maps</p>
<p>
With Maps you may for instance:</p>
<taglist>
<tag/> <item><c>M0 = #{ a => 1, b => 2}, % create
associations</c></item>
<tag/><item><c>M1 = M0#{ a := 10 }, % update values</c></item>
<tag/><item><c>M2 = M1#{ "hi" =>
"hello"}, % add new associations</c></item>
<tag/><item><c>#{ "hi" := V1, a := V2, b := V3} = M2.
% match keys with values</c></item>
</taglist>
<p>
For information on how to use Maps please see Map Expressions in the
<seealso marker="doc/reference_manual:expressions#map_expressions">
Reference Manual</seealso>.</p>
<p>
The current implementation is without the following
features:</p>
<taglist>
<tag/><item>No variable keys</item>
<tag/><item>No single value access</item>
<tag/><item>No map comprehensions</item>
</taglist>
<p>
Note that Maps is <em>experimental</em> during OTP 17.0.</p>
<p>
Own Id: OTP-11616</p>
</item>
<item>
<p> Parameterized opaque types have been introduced. </p>
<p>
Own Id: OTP-11625</p>
</item>
<item>
<p>
Some function specs are corrected or moved and some edoc
comments are corrected in order to allow use of edoc.
(Thanks to Pierre Fenoll)</p>
<p>
Own Id: OTP-11702</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.6.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> A bug that made it impossible to do any analyses from
the GUI has been fixed. </p>
<p>
Own Id: OTP-11057 Aux Id: seq12313 </p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Include module, function and arity in Dialyzer's
"overlapping domain" warnings. Thanks to Magnus Henoch.</p>
<p>
Own Id: OTP-10918</p>
</item>
<item>
<p>
Improve Dialyzer output for scan errors. Thanks to Magnus
Henoch.</p>
<p>
Own Id: OTP-10996</p>
</item>
<item>
<p>
Integrate elliptic curve contribution from Andreas
Schultz </p>
<p>
In order to be able to support elliptic curve cipher
suites in SSL/TLS, additions to handle elliptic curve
infrastructure has been added to public_key and crypto.</p>
<p>
This also has resulted in a rewrite of the crypto API to
gain consistency and remove unnecessary overhead. All OTP
applications using crypto has been updated to use the new
API.</p>
<p>
Impact: Elliptic curve cryptography (ECC) offers
equivalent security with smaller key sizes than other
public key algorithms. Smaller key sizes result in
savings for power, memory, bandwidth, and computational
cost that make ECC especially attractive for constrained
environments.</p>
<p>
Own Id: OTP-11009</p>
</item>
<item>
<p>
Bitstring type inference and duplicate module error
message fixes. Thanks to Stavros Aronis.</p>
<p>
Own Id: OTP-11027</p>
</item>
<item>
<p>Erlang source files with non-ASCII characters are now
encoded in UTF-8 (instead of latin1).</p>
<p>
Own Id: OTP-11041 Aux Id: OTP-10907 </p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.6</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Miscellaneous updates due to Unicode support. </p>
<p>
Own Id: OTP-10820</p>
</item>
<item>
<p>
User defined types with same name and different arity and
documentation inconsistencies. Thanks Stavros Aronis.</p>
<p>
Own Id: OTP-10861</p>
</item>
<item>
<p>
Native code compilation changes. Thanks to Kostis
Sagonas.</p>
<p>
Own Id: OTP-10865</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.5.4</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Support for Unicode has been implemented. </p>
<p>
Own Id: OTP-10302</p>
</item>
<item>
<p> Dialyzer no longer outputs warnings for unused
anonymous functions ("funs"). Warnings are still output
for unused functions. </p>
<p>
Own Id: OTP-10433</p>
</item>
<item>
<p>Where necessary a comment stating encoding has been
added to Erlang files. The comment is meant to be removed
in Erlang/OTP R17B when UTF-8 becomes the default
encoding. </p>
<p>
Own Id: OTP-10630</p>
</item>
<item>
<p> Some examples overflowing the width of PDF pages have
been corrected. </p>
<p>
Own Id: OTP-10665</p>
</item>
<item>
<p>
Fix precision of record creation violation warnings.
Thanks to Stavros Aronis</p>
<p>
Own Id: OTP-10681</p>
</item>
<item>
<p>
Report spec discrepancy on mismatching lists. Thanks to
Stavros Aronis.</p>
<p>
Own Id: OTP-10740</p>
</item>
<item>
<p>
Properly support functions with arbitrary arity in type
specs. Thanks to Stavros Aronis.</p>
<p>
Own Id: OTP-10772</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.5.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>Fix a crash in race condition detection</p> <p>Remove
old untested experimental extension</p> <p>Respect
{plt_check,false} option when using dialyzer:run/1</p>
<p>Fix handling of tuple set remote types appearing in
tuple sets</p>
<p>
Own Id: OTP-10464</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.5.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> Correct handling of type names in contracts. Fix
crash related to contract checking. Do not rewrite
unchanged PLT. </p>
<p>
Own Id: OTP-10083</p>
</item>
<item>
<p>
Stop a forgotten server process</p>
<p>
Dialyzer forgot to stop a server process before finishing
its analysis. This is a concurrency error detected by
Concuerror. Changes to fix warnings identified by running
dialyzer -Wunmatched_returns. Thanks to Kostis Sagonas.</p>
<p>
Own Id: OTP-10231</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Bug fixes and improvements of
<c>dialyzer_typesig</c>. </p>
<p>
Own Id: OTP-10082</p>
</item>
<item>
<p>
Add parallel dialyzer support</p>
<p>
Own Id: OTP-10103</p>
</item>
<item>
<p> An alternative implementation of the solver in
<c>dialyzer_typesig</c> has been introduced. It is faster
than the original implementation. </p>
<p>
Own Id: OTP-10110</p>
</item>
<item>
<p> Bugs in <c>erl_types:t_inf()</c> (HiPE) and in
<c>dialyzer_dataflow</c> (Dialyzer) have been fixed. </p>
<p>
Own Id: OTP-10191</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.5.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Handle <c>nowarn_unused_function</c> the same way as
the compiler does. </p>
<p>
Own Id: OTP-9833</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.5</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Fix false warning about closure application</p>
<p>
Whenever a variable that could hold one of two or more
possible closures was used in a particular application,
the application was assumed to fail if ONE of the
closures would fail in this application. This has been
corrected to infer failing application if ALL possible
closures would fail in the particular application.</p>
<p>
Change category of 'might also return' warnings</p>
<p>
Dialyzer emits warnings like the following "The
specification for _ states that the function might also
return _ but the inferred return is _", which are
actually underspecifications and not wrong type
specifications. This patch makes sure that they are filed
under the appropriate category.</p>
<p>
Own Id: OTP-9707</p>
</item>
<item>
<p>Wrap up behaviours patch for Dialyzer</p> <list>
<item><p>Enable warnings by default, add two options for
suppressing them</p></item> <item><p>Fix warning
formatting and update testsuites.</p></item>
<item><p>Detection of callback-spec
discrepancies</p></item> <item><p>Allow none() as return
value in callbacks</p></item> <item><p>Behaviour callback
discrepancy detection for Dialyzer</p></item>
<item><p>Add lookup function for callbacks</p></item>
<item><p>Store callbacks in codeserver and PLT</p></item>
<item><p>Collect callback definitions during
compilation</p></item> <item><p>Update inets
results</p></item> </list>
<p>
Own Id: OTP-9731</p>
</item>
<item>
<list> <item><p>No warnings for underspecs with remote
types</p></item> <item><p> Fix crash in Typer</p></item>
<item><p>Fix Dialyzer's warning for its own
code</p></item> <item><p>Fix Dialyzer's warnings in
HiPE</p></item> <item><p>Add file/line info in a
particular Dialyzer crash</p></item> <item><p>Update
inets test results</p></item> </list>
<p>
Own Id: OTP-9758</p>
</item>
<item>
<list> <item><p>Correct callback spec in application
module</p></item> <item><p>Refine warning about callback
specs with extra ranges</p></item> <item><p>Cleanup
autoimport compiler directives</p></item> <item><p>Fix
Dialyzer's warnings in typer</p></item> <item><p>Fix
Dialyzer's warning for its own code</p></item>
<item><p>Fix bug in Dialyzer's behaviours
analysis</p></item> <item><p>Fix crash in
Dialyzer</p></item> <item><p>Variable substitution was
not generalizing any unknown variables.</p></item>
</list>
<p>
Own Id: OTP-9776</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Optimize the joining of maps in
<c>dialyzer_dataflow</c>. </p>
<p>
Own Id: OTP-9761</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.4.4</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Update results of race_SUITE/extract_translations Update
results of small_SUITE/flatten Add codec_can and
list_to_bitstring tests Fix bug when reporting unused
functions Update Dialyzer r9c_suite results Fix dialyzer
warning on default clause for binary comprehension
(Thanks to Ivan Dubrov)</p>
<p>
Own Id: OTP-9483</p>
</item>
<item>
<p>
Fix server loop detection</p>
<p>
Dialyzer does not normally emit warnings for functions
that implement non-terminating server loops. This
detection failed when some of the elements in an SCC
terminated normally (being for example list
comprehensions or other generic anonymous functions that
were included in the SCC). This patch fixes that.</p>
<p>
Own Id: OTP-9489</p>
</item>
<item>
<p>
Add a proplist() type</p>
<p>
Recently I was adding specs to an API and found that
there is no canonical proplist() type defined. (Thanks to
Ryan Zezeski)</p>
<p>
Own Id: OTP-9499</p>
</item>
<item>
<p>
Suppress some warnings about generation of non-returning
funs</p>
<p>
No warnings are emitted for funs that are non-returning
when the function that generates them has a contract that
specifies that it will return such a non-returning fun.</p>
<p>
Enhance Dialyzer's inference on comparisons</p>
<p>
This patch makes Dialyzer aware of Erlang's total
ordering of terms, enabling discrepancy detection in
cases where e.g. integer() < tuple() is treated as a
comparison that might also return false (when it is
certain to always return true).</p>
<p>
Minor fix in dead code</p>
<p>
Fix infinite loop in dataflow</p>
<p>
Update r9c/{inets,mnesia} results in dialyzer's test
suite</p>
<p>
Add origin information to #fun_var closures</p>
<p>
(Thanks to Tuncer Ayaz and Maria Christakis)</p>
<p>
Own Id: OTP-9529</p>
</item>
<item>
<p>
Quote atoms if necessary in types</p>
<p>
Atoms in some occurrences were not correctly quoted when
formatted to strings, for instance by the typer program
(Thanks to Tomas Abrahamsson)</p>
<p>
Update Dialyzer's reference results</p>
<p>
Own Id: OTP-9560</p>
</item>
<item>
<p>
Fix typer's crash for nonexisting files Remove unused
macro Fix bug in dataflow Decrease tuple arity limit This
fixes a memory related crash.</p>
<p>
Own Id: OTP-9597</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Types for several BIFs have been extended/corrected. Also
the types for types for <c>lists:keyfind/3</c>,
<c>lists:keysearch/3</c>, and <c>lists:keyemember/3</c>
have been corrected. The incorrect/incomplete types could
cause false dialyzer warnings.</p>
<p>
Own Id: OTP-9496</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.4.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Fix the name of an error function(Thanks to Maria
christakis)</p>
<p>
Own Id: OTP-9175</p>
</item>
<item>
<p>
Fix crash related with the contract blame assignment
patch</p>
<p>
Own Id: OTP-9219</p>
</item>
<item>
<p>
dialyzer/doc: synchronize manual.txt and dialyzer.xml
(Thanks to Tuncer Ayaz)</p>
<p>
Own Id: OTP-9226</p>
</item>
<item>
<p>
Simplify Dialyzer's test suite structure</p>
<p>
*_SUITE.erl files are now automatically generated by the
respective data directories by the Makefile.</p>
<p>
Own Id: OTP-9278</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.4.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Add a --fullpath option to Dialyzer</p>
<p>
This change adds a --fullpath option to Dialyzer, which
makes the warning messages contain the full path of the
corresponding file.</p>
<p>
Original patch submitted by Magnus Henoch (legoscia) on
15/9/2010 and cooked to death in the 'pu' branch all this
time.</p>
<p>
The patch was essentially correct and most of it has been
used as is, but there have been some changes to make the
code slightly prettier, avoid some code duplication, and
add documentation to dialyzer's doc files and to its help
message.</p>
<p>
Own Id: OTP-9098</p>
</item>
<item>
<p>
Fix warnings about guards containing not</p>
<p>
The wording of warnings about unsatisfiable guards that
used 'not' was incorrect (the 'not' was not mentioned and
it appeared as "Guard test is_atom(atom()) can never
succeed") (thanks to Stavros Aronis).</p>
<p>
Own Id: OTP-9099</p>
</item>
<item>
<p>
Version 2.4.2 (in Erlang/OTP R14B02)
------------------------------------ - Added --fullpath
option to display files with warnings with their full
file names (thanks to Magnus Henoch for the original
patch). - Better handling of 'and'/'or'/'not' guards that
generate warnings (thanks to Stavros Aronis). - Better
blame assignment for cases when a function's spec is
erroneous (thanks to Stavros Aronis). - More descriptive
warnings when a tuple/record pattern contains subterms
that violate the declared types of record fields (thanks
to Matthias Lang for the test case and for Stavros Aronis
for the actual fix).</p>
<p>
Own Id: OTP-9126</p>
</item>
<item>
<p>
Add spec to dialyzer_cl_parse:get_lib_dir/1</p>
<p>
Own Id: OTP-9129</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Test suites for Dialyzer</p>
<p>
This is a transcription of most of the
cvs.srv.it.uu.se:/hipe repository dialyzer_tests into
test suites that use the test server framework.</p>
<p>
See README for information on how to use the included
scripts for modifications and updates.</p>
<p>
When testing Dialyzer it's important that several OTP
modules are included in the plt. The suites takes care of
that too.</p>
<p>
Own Id: OTP-9116</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.4.0</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> - Fixed pretty rare infinite loop when refining the
types of an SCC whose functions all returned none()
(thanks to Stavros Aronis). </p><p> - Fixed pretty rare
crash when taking the infimum of two tuple_sets. </p>
<p>
Own Id: OTP-8979</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> - Added ability to supply multiple PLTs for the
analysis (option --plts). Currently these PLTs must be
independent (i.e., no module appears in more than one
PLT) and there must not include files with module name
clashes.</p><p> - Strengthened and streamlined hard-coded
type information for some BIFs and key library
functions.</p>
<p>
Own Id: OTP-8962</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.3.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Eliminated warnings for auto-imported BIF clashes.</p>
<p>
Own Id: OTP-8840</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.3.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Various changes to dialyzer-related files for R14.</p>
<p>
- Dialyzer properly supports the new attribute
-export_type and checks that remote types only refer to
exported types. A warning is produced if some
files/applications refer to types defined in modules
which are neither in the PLT nor in the analyzed
applications.</p>
<p>
- Support for detecting data races involving whereis/1
and unregister/1.</p>
<p>
- More precise identification of the reason(s) why a
record construction violates the types declared for its
fields.</p>
<p>
- Fixed bug in the handling of the 'or' guard.</p>
<p>
- Better handling of the erlang:element/2 BIF.</p>
<p>
- Complete handling of Erlang BIFs.</p>
<p>
Own Id: OTP-8699</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.2.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Much better support for opaque types (thanks to Manouk
Manoukian).</p>
<p>Added support for recursive types (experimental).</p>
<p>Added support for parameterized modules.</p>
<p>Dialyzer now warns when -specs state that a function
returns some type when in fact it does not.</p>
<p>Added <c>--no_native</c> (<c>-nn</c>) option so that
the user can bypass the native code compilation that
dialyzer heuristically performs when dialyzing many
files.</p>
<p>Fixed minor bug in the dialyzer script allowing the
--wx option to bring up the wx-based GUI regardless of
its placement in the options list.</p>
<p>Options --apps and -Wrace_conditions, which were added
in the previous version, are now properly documented in
the manual.</p>
<p>
Own Id: OTP-8464</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.1.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The documentation is now built with open source tools
(xsltproc and fop) that exists on most platforms. One
visible change is that the frames are removed.</p>
<p>
Own Id: OTP-8201</p>
</item>
<item>
<p>
Dialyzer can statically detect some kinds of data races
in Erlang programs. Use the new option -Wrace_conditions
to enable the race analysis. The technique is described
in a paper which is available at:
http://www.it.uu.se/research/group/hipe/dialyzer/publications/races.pdf</p>
<p>
Added support for packages (thanks to Maria Christakis).</p>
<p>
There has been a major change in the default mode of
Dialyzer. Previously, the default mode was the GUI, while
now it is the command line. As a result of this change,
it is now possible to analyze a set of files/dirs with
the command: </p><list> <item>dialyzer file1 ...
fileN</item> </list><p> In other words, the -c
(--command-line) option is no longer necessary, though it
will be retained for some time for backwards
compatibility. To start dialyzer's GUI use either of the
following commands: </p><list> <item>dialyzer --gui %%
for the old gs-based GUI</item> <item>dialyzer --wx %%
for the new wx-based GUI (where available)</item>
</list><p></p>
<p>
There is a new option --apps which allows the user to
easily refer to Erlang/OTP applications and include them
in the analysis or in the building of the PLT. For
example, we recommend building the PLT with: </p><list>
<item>dialyzer --build_plt --apps erts kernel stdlib
mnesia ...</item> </list><p></p>
<p>
The new option can also take absolute file names as well
as applications. Note that the application versions that
will be included in the PLT are those that correspond to
the Erlang/OTP system which is used.</p>
<p>
Dialyzer has a new wxWidgets based GUI (thanks to Elli
Frangaki) for platforms where the wx application is
available.</p>
<p>
Own Id: OTP-8300</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 2.0.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>There is a major addition to the capabilities of
dialyzer, worthy of bumping the version number. Starting
with this version, dialyzer not only accepts but also
properly processes remote types (i.e., types of the form
ModuleName:TypeName()). Previous dialyzer versions only
accepted this notation in -type and -spec declarations,
but effectively ignored its information by mapping remote
types to the type any(). In contrast, starting with this
version, remote types are used in the analysis and are
also stored in the PLTs. (This addition changes the
format of PLTs and requires rebuilding any PLTs created
by an older dialyzer version.) Note that dialyzer will
complain and abort the analysis of a set of modules if it
needs to process a remote type without a definition
(either because the module does not include a definition
of the type or the module is not included in the
analysis). We may relax this restriction in a future
version.</p>
<p>Fixed minor issue with dialyzer:run/1 crashing (upon
its return) when used for adding type information to an
existing PLT.</p>
<p>Fixed minor but quite annoying issues in dialyzer's
GUI.</p>
<p>
Own Id: OTP-8187</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.9.2</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Fixed problem with type inference going into an
infinite loop when analyzing a strongly connected
component of functions that do not return but also
contain an erroneous call which makes them fail and be
assigned the type none() instead of the type unit().</p>
<p>More accurate type information for some BIFs and
library files.</p>
<p>Introduced boolean() as the `official' name for the
type was so far known as bool(). The latter is still
accepted as well as boolean().</p>
<p>
Own Id: OTP-8037</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.9.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Has better handling of opaque types.</p>
<p>The handling of UTF segments of bitstreams has been
significantly strengthened and revised. In all
probability, now it is correct.</p>
<p>
Own Id: OTP-7958</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.9.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>The analysis accepts opaque type declarations and
detects violations of opacity of terms of such types.
Starting with R13, many Erlang/OTP standard libraries
(array, dict, digraph, ets, gb_sets, gb_trees, queue, and
sets) contain opaque type declarations of their main data
types. Dialyzer will spit out warnings in code that
explicitly depends on the structure of these terms.</p>
<p>Added support for handling UTF segments in bitstreams
and for detecting obvious type errors in these segments.
Warning: This code is not terribly tested though since
there are very few Erlang programs which use
Unicode-based binaries - not surprising since this is a
new language feature of R13.</p>
<p>Strengthened the discrepancy identification when
testing for equality and matching between terms of
different types. This detects more bugs in code.</p>
<p>Added warning for M:F(...) calls where M is not a
module term and F is not an atom. Previously, such calls
where found to fail but the reason for the failure was
not reported.</p>
<p>Added a convenient shorthand for the --no_check_plt
option (-n).</p>
<p>Added the --dump_callgraph option for dumping the
callgraph of all files that are analyzed into a specified
file. The callgraph either be dumped in raw format, in
.dot format, or converted to a .ps (postscript) file.
Note that in large callgraphs the generated postscript
file might not be interpretable by Ghostview. (Thanks to
Ilya Khlopotov for the initial version of this
functionality.)</p>
<p>
Own Id: OTP-7864</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.8.3</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Added the <c>--no_check_plt</c> option that makes the
startup time faster when working with stable PLTs that do
not change.</p>
<p>Changed the phrasing of some warnings so that they do
not cause confusion to some users and correspond better
to reality.</p>
<p>
Own Id: OTP-7632</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.8.2</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Minor updates.</p>
<p>
Own Id: OTP-7522</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.8.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
There is new <c>--raw</c> option for Dialyzer to output
the result of the analysis in Erlang term, to facilitate
later filtering and/or formatting.</p>
<p>
Own Id: OTP-7386</p>
</item>
<item>
<p>The return type of the Erlang interface dialyzer:run/1
has changed to only return a list of warnings. If
something goes wrong dialyzer dies with an exception.</p>
<p>The handling of the PLT is now more flexible. There is
no longer any default PLT included with OTP. Please
consult the manual for the changes.</p>
<p>
Own Id: OTP-7389</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.8.0</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Dialyzer's analysis is from now on exclusively based
on success typings. In particular, support for options
<c>--old_style</c> and <c>--dataflow</c> has been
discontinued.</p>
<p>Better and more aggressive handling of type
information in records.</p>
<p>Dialyzer has a new warning option
<c>-Wunmatched_returns</c> which warns for function calls
that ignore the return value. This catches many common
programming errors (e.g. calling <c>file:close/1</c> and
not checking for the absence of errors), interface
discrepancies (e.g. a function returning multiple values
when in reality the function is void and only called for
its side-effects), calling the wrong function (e.g.
<c>io_lib:format/1</c> instead of <c>io:format/1</c>),
and even possible performance defects (e.g. unnecessarily
constructing a list using a list comprehension instead of
using <c>lists:foreach/2</c>). Whenever a function
returns a single atomic value (e.g. 'ok' or pid()), the
warning is suppressed. This allows for "void" functions
(returning a single atom like 'ok') or for calls to
certain builtins like <c>spawn</c>. Because not all calls
which ignore the return value are discrepancies, the
option is off by default and has to be explicitly
requested by the user. But we recommend it
nevertheless.</p>
<p>Some warning options (<c>-Wno_comp</c>,
<c>-Wno_guards</c>, <c>-Wno_unsafe_beam</c>, etc.) which
could be used when analyzing bytecode produced by an old
BEAM compiler have been removed.</p>
<p>
Own Id: OTP-7241</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.7.2</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The warnings returned by the Erlang interface now
contains a tag describing the type of warning.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-7134</p>
</item>
</list>
</section>
</section>
<section><title>Dialyzer 1.7.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Use of success typings is now default, is robust and
detects significantly more errors than in previous
versions.</p>
<p>Dialyzer now accepts and takes into account type
information in record declarations and in contracts --
see related paper in Erlang'07 workshop. Various OTP
applications (e.g. stdlib and kernel) are partially
annotated with appropriate contracts specifying types
information for their functions.</p>
<p>The type previously known as unit() has been renamed
to no_return(). Its use in a contract as the return type
of a function now silences off the "function has no local
return" dialyzer warning without use of the corresponding
option.</p>
<p>
Own Id: OTP-6997</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.7.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Minor Makefile changes.</p>
<p>Own Id: OTP-6689</p>
</item>
<item>
<p>Dialyzer can now use success typings to find
discrepancies. As a consequence significantly more
discrepancies are detected. The downside is that the
analysis takes about 2 to 2.5 times longer than in
previous versions, and may also result in some warnings
that might be harder to interpret even though they are
correct. This has been a major change, worth of
increasing the version number.</p>
<p>New command-line options:</p>
<p>--succ_typings Use the success typings analysis.</p>
<p>--dataflow (default) Use the previous analysis.</p>
<p>The new type unit() has been introduced to handle the
return type of non-terminating functions such as
servers.</p>
<p>Dialyzer's code server uses a compressed
representation and the analysis requires significantly
less memory than in previous versions.</p>
<p>Own Id: OTP-6736</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.6.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Dialyzer (in the modes where either source or BEAM
code which contains debug_info is analyzed) spits out
line information for all discrepancies. This has been a
major change, worth of increasing the version number.</p>
<p>We warn users that *considerably* more discrepancies
are identified by this version of Dialyzer compared with
previous ones and applications. If, for some reason,
warnings generated by previous versions of Dialyzer are
preferable, the command line option --old_style can be
employed.</p>
<p>Own Id: OTP-6546</p>
</item>
<item>
<p>Dialyzer handles term comparison operators more
precisely and is able to identify more discrepancies in
'if' or 'case' statements with comparisons.</p>
<p></p>
<p>Dialyzer has more precise type information for many
standard OTP functions.</p>
<p>Own Id: OTP-6547</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.5.1</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Updated the chapter "More on the Persistent Lookup Table
(PLT)" in Dialyzer User's Guide and added information on
how to use Dialyzer from Erlang to <c><![CDATA[dialyzer(3)]]></c>.
Also, the Dialyzer text files used by its GUI are now
included in the Erlang/OTP release.</p>
<p>Own Id: OTP-6361</p>
</item>
<item>
<p>New options <c><![CDATA[--check_init_plt]]></c> and
<c><![CDATA[--verbose]]></c>.</p>
<p>Improvements in the analysis (meaning that this
version can find more discrepancies than the previous
version).</p>
<p>Own Id: OTP-6421</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.5.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Dialyzer's building of PLT is based on a different
type inference algorithm. More specifically, Dialyzer
uses inference of refined success typings to infer
function prototypes. As a result, Dialyzer bases its
analysis on a significantly more powerful basis and thus
is able to detect more discrepancies. The downside is
that building the PLT is a considerably slower process.
We will work on improving that.</p>
<p>Dialyzer takes into account the BEAM compiler
directive <c><![CDATA[-compile({nowarn_unused_function, {F,A}}).]]></c> and then suppresses the warning that
function F/A will never be called.</p>
<p>Dialyzer's default initial PLT now also includes
"mnesia".</p>
<p>Own Id: OTP-6304</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.4.2</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Improvements in PLT management.</p>
<p>Own Id: OTP-6128</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.4.1</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Some minor changes.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Some minor changes.</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.4.0</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Changes for Dialyzer to work with Erlang/OTP R10B-10.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Dialyzer's analysis is significantly faster as it uses a global function
call-graph for obtaining type signatures for all analyzed functions.</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.3.1</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Small changes for Dialyzer to work with Erlang/OTP R10B-5.</p>
</item>
<item>
<p>Fixed a small buglet in the analysis; this affected one of HiPE's files.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Modified setup script for execution under Cygwin (patch by Vlad Dumitrescu).</p>
</item>
<item>
<p>Added command line option --no_warn_on_inline.</p>
</item>
<item>
<p>Dialyzer now explicitly warns when modules with the same name
but from different dirs are being analyzed (contribution by Ulf Wiger).</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.3.0</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Fixed a number of false positives that Dialyzer 1.2.0 was spitting out.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Requires the presence of an Erlang/OTP R10B-4 system.</p>
</item>
<item>
<p>Dialyzer is significantly (approx 40%) faster since it now uses 'ets'
rather than 'dets' for its PLT.</p>
</item>
<item>
<p>Slightly improved the precision of the analysis.</p>
</item>
<item>
<p>In the GUI version, Dialyzer now reports the list of modules that should
be included in the modules to analyze in order to possibly improve
the accuracy of the reported results.</p>
</item>
<item>
<p>Some more information is displayed when calling a function or closure
with arguments of the wrong type.</p>
</item>
<item>
<p>The record guard now allows discrepancies involving tuples that are known
to be records to be displayed as #rec{} rather than {'rec',_,...,_}</p>
</item>
<item>
<p>Added -q option which makes the command-line version of Dialyzer
a bit more silent.</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.2.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Dialyzer works with the open source and commercial versions of Erlang/OTP
R10B-2 on all platforms (i.e., HiPE support is not a prerequisite anymore).</p>
</item>
<item>
<p>Whenever a .beam file contains abstract code (i.e., has been compiled
with the +debug_info option), the analysis starts from this code rather
than from BEAM bytecode -- this makes the results identical to those
obtained by analysis starting from source code.
(This is a contribution from Bjorn Gustavsson - Thanks!)</p>
</item>
<item>
<p>Added -pa command line option for easier handling of -include_lib()
directives in source code.</p>
</item>
<item>
<p>Includes all changes added in v1.1.1; see below. The "Add Recursively"
functionality is also available in the command-line mode (-r option).</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.1.1</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Fixed problems using the shell script on Solaris machines.</p>
</item>
<item>
<p>Fixed small inconsistencies in Dialyzer's documentation and help.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>The command-line mode of Dialyzer spits discrepancies in stdout
by default and returns a numeric value indicating its exit status.</p>
</item>
<item>
<p>Added "Add Recursively" button contributed by Martin Bjorklund (thanks!).</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.1.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Dialyzer works with the open source version of Erlang/OTP R10B-1 (on
platforms where HiPE support is available) and it does not require
installation of a customized Erlang/OTP system anymore.</p>
</item>
<item>
<p>Dialyzer comes with an extensive command-line interface, in addition
to an enhanced GUI.</p>
</item>
<item>
<p>Analysis can start from source code (through Core Erlang) as well as
from BEAM bytecode.</p>
</item>
<item>
<p>Dialyzer finds considerably more discrepancies in Erlang code than
previous versions.</p>
</item>
<item>
<p>Added ability to selectively turn on/off different warning categories.</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.0.1</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Fixed major bug of v1.0.0 which caused the analysis to stop prematurely
(i.e., without properly reaching fixpoint) when analyzing more than one
module. This did not affect correctness of the results, but lost many
opportunities to detect discrepancies.</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Performance improvements in the analysis.</p>
</item>
</list>
</section>
</section>
<section>
<title>Dialyzer 1.0.0</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Initial Dialyzer version: Analysis starts from BEAM bytecode only and
only a GUI version is available. Dialyzer reports discrepancies in the
use of the "sequential" part of Erlang. To be used, Dialyzer requires
the presence of a specific snapshot of Erlang/OTP which can be obtained
from Dialyzer's homepage.</p>
</item>
</list>
</section>
</section>
</chapter>
|