-
Notifications
You must be signed in to change notification settings - Fork 2.9k
/
notes.xml
4386 lines (4204 loc) · 153 KB
/
notes.xml
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
<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
<header>
<copyright>
<year>2004</year><year>2012</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>
The contents of this file are subject to the Erlang Public License,
Version 1.1, (the "License"); you may not use this file except in
compliance with the License. You should have received a copy of the
Erlang Public License along with this software. If not, it can be
retrieved online at http://www.erlang.org/.
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
the License for the specific language governing rights and limitations
under the License.
</legalnotice>
<title>STDLIB Release Notes</title>
<prepared></prepared>
<docno></docno>
<date></date>
<rev></rev>
<file>notes.xml</file>
</header>
<p>This document describes the changes made to the STDLIB application.</p>
<section><title>STDLIB 1.18.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Fixed bug where if given an invalid drive letter on
windows ensure dir would go into an infinite loop.</p>
<p>
Own Id: OTP-10104</p>
</item>
<item>
<p>
Calls to gen_server:enter_loop/4 where ServerName has a
global scope and no timeout is given now works correctly.</p>
<p>
Thanks to Sam Bobroff for reporting the issue.</p>
<p>
Own Id: OTP-10130</p>
</item>
<item>
<p>
fix escript/primary archive reloading</p>
<p>
If the mtime of an escript/primary archive file changes
after being added to the code path, correctly reload the
archive and update the cache. (Thanks to Tuncer Ayaz)</p>
<p>
Own Id: OTP-10151</p>
</item>
<item>
<p>
Fix bug that in some cases could cause corrupted binaries
in ETS tables with <c>compressed</c> option.</p>
<p>
Own Id: OTP-10182</p>
</item>
<item>
<p>
Fix filename:nativename/1 on Win32</p>
<p>
Don't choke on paths given as binary argument on Win32.
Thanks to Jan Klötzke</p>
<p>
Own Id: OTP-10188</p>
</item>
<item>
<p>
Fix bug in <c>ets:test_ms/2</c> that could cause emulator
crash when using <c>'$_'</c> in match spec.</p>
<p>
Own Id: OTP-10190</p>
</item>
<item>
<p>
Fix bug where zip archives wrongly have a first disk
number set to 1</p>
<p>
Own Id: OTP-10223</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> The message printed by the Erlang shell as an
explanation of the <c>badarith</c> error has been
corrected. (Thanks to Matthias Lang.) </p>
<p>
Own Id: OTP-10054</p>
</item>
</list>
</section>
</section>
<section><title>STDLIB 1.18.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
References to <c>is_constant/1</c> (which was removed in
the R12 release) has been removed from documentation and
code.</p>
<p>
Own Id: OTP-6454 Aux Id: seq10407 </p>
</item>
<item>
<p>
Leave control back to gen_server during supervisor's
restart loop</p>
<p>
When an attempt to restart a child failed, supervisor
would earlier keep the execution flow and try to restart
the child over and over again until it either succeeded
or the restart frequency limit was reached. If none of
these happened, supervisor would hang forever in this
loop.</p>
<p>
This commit adds a timer of 0 ms where the control is
left back to the gen_server which implements the
supervisor. This way any incoming request to the
supervisor will be handled - which could help breaking
the infinite loop - e.g. shutdown request for the
supervisor or for the problematic child.</p>
<p>
This introduces some incompatibilities in stdlib due to
new return values from supervisor: <list>
<item>restart_child/2 can now return
{error,restarting}</item> <item>delete_child/2 can now
return {error,restarting}</item> <item>which_children/1
returns a list of {Id,Child,Type,Mods}, where Child, in
addition to the old pid() or 'undefined', now also can be
'restarting'.</item> </list></p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9549</p>
</item>
<item>
<p>
If a temporary child's start function returned 'ignore',
then the supervisor would keep it's child specification.
This has been corrected. Child specifications for
non-existing temporary children shall never be kept.</p>
<p>
Own Id: OTP-9782 Aux Id: seq11964 </p>
</item>
<item>
<p> Use universal time as base in error logger
<p>
Previous conversion used the deprecated
calendar:local_time_to_universal_time/1 </p></p>
<p>
Own Id: OTP-9854</p>
</item>
<item>
<p>Calling a guard test (such as is_list/1) from the
top-level in a guard, would cause a compiler crash if
there was a local definition with the same name.
Corrected to reject the program with an error
message.</p>
<p>
Own Id: OTP-9866</p>
</item>
<item>
<p>
Fix the type spec from the doc of binary:part/3 (Thanks
to Ricardo Catalinas Jiménez)</p>
<p>
Own Id: OTP-9920</p>
</item>
<item>
<p>
Correct spelling of registered (Thanks to Richard
Carlsson)</p>
<p>
Own Id: OTP-9925</p>
</item>
<item>
<p>
Put gb_trees documentation into alphabetical order
(Thanks to Aidan Hobson Sayers)</p>
<p>
Own Id: OTP-9929</p>
</item>
<item>
<p>
Fix bug in ETS with <c>compressed</c> option and
insertion of term containing large integers (>2G) on
64-bit machines. Seen to cause emulator crash. (Thanks to
Diego Llarrull for excellent bug report)</p>
<p>
Own Id: OTP-9932</p>
</item>
<item>
<p>
Add plugin support for alternative name lookup This patch
introduces a new way of locating a behaviour instance:
{via, Module, Name}. (Thanks to Ulf Wiger)</p>
<p>
Own Id: OTP-9945</p>
</item>
<item>
<p> The function <c>digraph_utils:condensation/1</c> used
to create a digraph containing loops contradicting the
documentation which states that the created digraph is
free of cycles. This bug has been fixed. (Thanks to
Kostis Sagonas for finding the bug.) </p>
<p>
Own Id: OTP-9953</p>
</item>
<item>
<p> When an escript ends now all printout to standard
output and standard error gets out on the terminal. This
bug has been corrected by changing the behaviour of
erlang:halt/0,1, which should fix the same problem for
other escript-like applications, i.e that data stored in
the output port driver buffers got lost when printing on
a TTY and exiting through erlang:halt/0,1. </p>
<p> The BIF:s erlang:halt/0,1 has gotten improved
semantics and there is a new BIF erlang:halt/2 to
accomplish something like the old semantics. See the
documentation. </p>
<p> Now erlang:halt/0 and erlang:halt/1 with an integer
argument will close all ports and allow all pending async
threads operations to finish before exiting the emulator.
Previously erlang:halt/0 and erlang:halt(0) would just
wait for pending async threads operations but not close
ports. And erlang:halt/1 with a non-zero integer argument
would not even wait for pending async threads operations.
</p>
<p> To roughly the old behaviour, to not wait for ports
and async threads operations when you exit the emulator,
you use erlang:halt/2 with an integer first argument and
an option list containing {flush,false} as the second
argument. Note that now is flushing not dependant of the
exit code, and you can not only flush async threads
operations which we deemed as a strange behaviour anyway.
</p>
<p>Also, erlang:halt/1,2 has gotten a new feature: If the
first argument is the atom 'abort' the emulator is
aborted producing a core dump, if the operating system so
allows. </p>
<p>
Own Id: OTP-9985</p>
</item>
<item>
<p>
Add escript win32 alternative invocation. escript can now
be started as both "escript.exe" and "escript" (Thanks to
Pierre Rouleau)</p>
<p>
Own Id: OTP-9997</p>
</item>
</list>
</section>
</section>
<section><title>STDLIB 1.18</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Improved algorithm in module <c>random</c>. Avoid seed
values that are even divisors of the primes and by that
prevent getting sub-seeds that are stuck on zero. Worst
case was random:seed(0,0,0) that produced a series of
only zeros. This is an incompatible change in the sense
that applications that relies on reproducing a specific
series for a given seed will fail. The pseudo random
output is still deterministic but different compared to
earlier versions.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-8713</p>
</item>
<item>
<p> Calls to <c>global:whereis_name/1</c> have been
substituted for calls to
<c>global:safe_whereis_name/1</c> since the latter is not
safe at all.</p>
<p>The reason for not doing this earlier is that setting
a global lock masked out a bug concerning the restart of
supervised children. The bug has now been fixed by a
modification of <c>global:whereis_name/1</c>. (Thanks to
Ulf Wiger for code contribution.)</p>
<p>A minor race conditions in <c>gen_fsm:start*</c> has
been fixed: if one of these functions returned <c>{error,
Reason}</c> or ignore, the name could still be registered
(either locally or in <c>global</c>. (This is the same
modification as was done for gen_server in OTP-7669.)</p>
<p>The undocumented function
<c>global:safe_whereis_name/1</c> has been removed. </p>
<p>
Own Id: OTP-9212 Aux Id: seq7117, OTP-4174 </p>
</item>
<item>
<p>
If a child of a supervisor terminates with reason
{shutdown,Term} it is now handled by the supervisor as if
the reason was 'shutdown'. </p>
<p>
For children with restart type 'permanent', this implies
no change. For children with restart type 'transient',
the child will no longer be restarted and no supervisor
report will be written. For children with restart type
'temporary', no supervisor report will be written.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9222</p>
</item>
<item>
<p>
Minor improvement of documentation regarding supervisor
restart strategy for temporary and transient child
processes.</p>
<p>
Own Id: OTP-9381</p>
</item>
<item>
<p>A Dets table with sufficiently large buckets could not
always be repaired. This bug has been fixed. </p> <p>The
format of Dets files has been modified. When downgrading
tables created with the new system will be repaired.
Otherwise the modification should not be noticeable. </p>
<p>
Own Id: OTP-9607</p>
</item>
<item>
<p> A few contracts in the <c>lists</c> module have been
corrected. </p>
<p>
Own Id: OTP-9616</p>
</item>
<item>
<p>
Add '-callback' attributes in stdlib's behaviours</p>
<p>
Replace the behaviour_info(callbacks) export in stdlib's
behaviours with -callback' attributes for all the
callbacks. Update the documentation with information on
the callback attribute Automatically generate
'behaviour_info' function from '-callback' attributes</p>
<p>
'behaviour_info(callbacks)' is a special function that is
defined in a module which describes a behaviour and
returns a list of its callbacks.</p>
<p>
This function is now automatically generated using the
'-callback' specs. An error is returned by lint if user
defines both '-callback' attributes and the
behaviour_info/1 function. If no type info is needed for
a callback use a generic spec for it. Add '-callback'
attribute to language syntax</p>
<p>
Behaviours may define specs for their callbacks using the
familiar spec syntax, replacing the '-spec' keyword with
'-callback'. Simple lint checks are performed to ensure
that no callbacks are defined twice and all types
referred are declared.</p>
<p>
These attributes can be then used by tools to provide
documentation to the behaviour or find discrepancies in
the callback definitions in the callback module.</p>
<p>
Add callback specs into 'application' module in kernel
Add callback specs to tftp module following internet
documentation Add callback specs to inets_service module
following possibly deprecated comments</p>
<p>
Own Id: OTP-9621</p>
</item>
<item>
<p> If a Dets table had been properly closed but the
space management data could not been read, it was not
possible to repair the file. This bug has been fixed.
</p>
<p>
Own Id: OTP-9622</p>
</item>
<item>
<p>
The Unicode noncharacter code points 16#FFFE and 16#FFFE
were not allowed to be encoded or decoded using the
<c>unicode</c> module or bit syntax. That was
inconsistent with the other noncharacters 16#FDD0 to
16#FDEF that could be encoded/decoded. To resolve the
inconsistency, 16#FFFE and 16#FFFE can now be encoded and
decoded. (Thanks to Alisdair Sullivan.)</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9624</p>
</item>
<item>
<p>
Make epp search directory of current file first when
including another file This completes a partial fix in
R11 that only worked for include_lib(). (Thanks to
Richard Carlsson)</p>
<p>
Own Id: OTP-9645</p>
</item>
<item>
<p>
ms_transform: Fix incorrect `variable shadowed' warnings</p>
<p>
This patch removes incorrect passing of variable bindings
from one function clause to another. (Thanks to Haitao
Li)</p>
<p>
Own Id: OTP-9646</p>
</item>
<item>
<p>
Explicitly kill dynamic children in supervisors</p>
<p>
According to the supervisor's documentation: "Important
note on simple-one-for-one supervisors: The dynamically
created child processes of a simple-one-for-one
supervisor are not explicitly killed, regardless of
shutdown strategy, but are expected to terminate when the
supervisor does (that is, when an exit signal from the
parent process is received)."</p>
<p>
All is fine as long as we stop simple_one_for_one
supervisor manually. Dynamic children catch the exit
signal from the supervisor and leave. But, if this
happens when we stop an application, after the top
supervisor has stopped, the application master kills all
remaining processes associated to this application. So,
dynamic children that trap exit signals can be killed
during their cleanup (here we mean inside terminate/2).
This is unpredictable and highly time-dependent.</p>
<p>
In this commit, supervisor module is patched to
explicitly terminate dynamic children accordingly to the
shutdown strategy.</p>
<p>
NOTE: Order in which dynamic children are stopped is not
defined. In fact, this is "almost" done at the same time.</p>
<p>
Stack errors when dynamic children are stopped</p>
<p>
Because a simple_one_for_one supervisor can have many
workers, we stack errors during its shutdown to report
only one message for each encountered error type. Instead
of reporting the child's pid, we use the number of
concerned children. (Thanks to Christopher Faulet)</p>
<p>
Own Id: OTP-9647</p>
</item>
<item>
<p>
Allow an infinite timeout to shutdown worker processes</p>
<p>
Now, in child specification, the shutdown value can also
be set to infinity for worker children. This restriction
was removed because this is not always possible to
predict the shutdown time for a worker. This is highly
application-dependent. Add a warning to docs about
workers' shutdown strategy (Thanks to Christopher Faulet)</p>
<p>
Own Id: OTP-9648</p>
</item>
<item>
<p>
A badarg would sometimes occur in supervisor when
printing error reports and the child pid was undefined.
This has been corrected.</p>
<p>
Own Id: OTP-9669</p>
</item>
<item>
<p>
Fix re:split spec not to accept option 'global'(Thanks to
Shunichi Shinohara)</p>
<p>
Own Id: OTP-9691</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Fix a few tests that used to fail on the HiPE
platform. </p>
<p>
Own Id: OTP-9637</p>
</item>
<item>
<p>Variables are now now allowed in '<c>fun M:F/A</c>' as
suggested by Richard O'Keefe in EEP-23.</p>
<p>The representation of '<c>fun M:F/A</c>' in the
abstract format has been changed in an incompatible way.
Tools that directly read or manipulate the abstract
format (such as parse transforms) may need to be updated.
The compiler can handle both the new and the old format
(i.e. extracting the abstract format from a pre-R15 BEAM
file and compiling it using compile:forms/1,2 will work).
The <c>syntax_tools</c> application can also handle both
formats.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9643</p>
</item>
<item>
<p>
Tuple funs (a two-element tuple with a module name and a
function) are now officially deprecated and will be
removed in R16. Use '<c>fun M:F/A</c>' instead. To make
you aware that your system uses tuple funs, the very
first time a tuple fun is applied, a warning will be sent
to the error logger.</p>
<p>
Own Id: OTP-9649</p>
</item>
<item>
<p>
The deprecated '<c>regexp</c>' module has been removed.
Use the '<c>re</c>' module instead.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9737</p>
</item>
<item>
<p>
<c>filename:find_src/1,2</c> will now work on stripped
BEAM files (reported by Per Hedeland). The HiPE compiler
will also work on stripped BEAM files. The BEAM compiler
will no longer include compilation options given in the
source code itself in <c>M:module_info(compile)</c>
(because those options will be applied anyway if the
module is re-compiled).</p>
<p>
Own Id: OTP-9752</p>
</item>
</list>
</section>
</section>
<section><title>STDLIB 1.17.5</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
erl_tar:extract failed when executed inside a directory
with some parent directory to which the user has no read
access. This has been corrected.</p>
<p>
Own Id: OTP-9368</p>
</item>
<item>
<p> A bug in <c>erl_scan:set_attribute/3</c> has been
fixed. </p>
<p>
Own Id: OTP-9412</p>
</item>
<item>
<p> The contract of <c>io_lib:fread()</c> has been
corrected. </p>
<p>
Own Id: OTP-9413 Aux Id: seq11873 </p>
</item>
<item>
<p>
A crash in io_lib:fread/2 when end of input data was
encountered while trying to match literal characters,
which should return {more,_,_,_} but instead crashed, has
been corrected. Reported by Klas Johansson.</p>
<p>
A similar peculiarity for io:fread when encountering end
of file before any field data has also been corrected.</p>
<p>
Own Id: OTP-9439</p>
</item>
<item>
<p> The contract of <c>timer:now_diff()</c> has been
corrected. (Thanks to Alex Morarash). </p>
<p>
Own Id: OTP-9450</p>
</item>
<item>
<p>
Fix minor typo in gen_fsm documentation (Thanks to Haitao
Li)</p>
<p>
Own Id: OTP-9456</p>
</item>
<item>
<p>The contracts of <c>zip:zip_list_dir/1</c> and
<c>zip:zip_get/2</c> have been corrected. </p>
<p>
Own Id: OTP-9471 Aux Id: seq11887, OTP-9472 </p>
</item>
<item>
<p> A bug in <c>zip:zip_open()</c> has been fixed. </p>
<p>
Own Id: OTP-9472 Aux Id: seq11887, OTP-9471 </p>
</item>
<item>
<p>
Fix trivial documentation errors(Thanks to Matthias Lang)</p>
<p>
Own Id: OTP-9498</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>
fix supervisors restarting temporary children</p>
<p>
In the current implementation of supervisors, temporary
children should never be restarted. However, when a
temporary child is restarted as part of a one_for_all or
rest_for_one strategy where the failing process is not
the temporary child, the supervisor still tries to
restart it.</p>
<p>
Because the supervisor doesn't keep some of the MFA
information of temporary children, this causes the
supervisor to hit its restart limit and crash.</p>
<p>
This patch fixes the behaviour by inserting a clause in
terminate_children/2-3 (private function) that will omit
temporary children when building a list of killed
processes, to avoid having the supervisor trying to
restart them again.</p>
<p>
Only supervisors in need of restarting children used the
list, so the change should be of no impact for the
functions that called terminate_children/2-3 only to kill
all children.</p>
<p>
The documentation has been modified to make this
behaviour more explicit. (Thanks to Fred Hebert)</p>
<p>
Own Id: OTP-9502</p>
</item>
<item>
<p>
fix broken edoc annotations (Thanks to Richard Carlsson)</p>
<p>
Own Id: OTP-9516</p>
</item>
<item>
<p> XML files have been corrected. </p>
<p>
Own Id: OTP-9550 Aux Id: OTP-9541 </p>
</item>
<item>
<p>
Handle rare race in the crypto key server functionality</p>
<p>
Own Id: OTP-9586</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p> Types and specifications have been added. </p>
<p>
Own Id: OTP-9356</p>
</item>
<item>
<p> The contracts of the <c>queue</c> module have been
modified. </p>
<p>
Own Id: OTP-9418</p>
</item>
<item>
<p> Contracts in STDLIB and Kernel have been improved and
type errors have been corrected. </p>
<p>
Own Id: OTP-9485</p>
</item>
<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>STDLIB 1.17.4</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p> The default value <c>undefined</c> was added to
records field types in such a way that the result was not
always a well-formed type. This bug has been fixed. </p>
<p>
Own Id: OTP-9147</p>
</item>
<item>
<p>
Update index file atomically</p>
<p>
Since the log_mf_h index file might be read by other
processes than the error handler (e.g. by the rb tool),
this file should be updated atomically. This will avoid
hitting the time gap between opening the file in write
mode (and thus emptying the file) and the actual update
with the new contents. To do this, a temporary file is
written, and the file:rename/1 used to replace the real
index file.</p>
<p>
Own Id: OTP-9148</p>
</item>
<item>
<p>
Fixed various typos across the documentation (Thanks to
Tuncer Ayaz)</p>
<p>
Own Id: OTP-9154</p>
</item>
<item>
<p>
Supervisors should not save child-specs for temporary
processes when they terminate as they should not be
restarted. Saving the temporary child spec will result in
that you can not start a new temporary process with the
same child spec as an already terminated temporary
process. Since R14B02 you can not restart a temporary
temporary process as arguments are no longer saved, it
has however always been semantically incorrect to restart
a temporary process. Thanks to Filipe David Manana for
reporting this and suggesting a solution.</p>
<p>
Own Id: OTP-9167 Aux Id: OTP-9064 </p>
</item>
<item>
<p>
Various small documentation fixes (Thanks to Bernard
Duggan)</p>
<p>
Own Id: OTP-9172</p>
</item>
<item>
<p>
Fix format_status bug for unregistered gen_event
processes</p>
<p>
Port the gen_fsm code for format_status to gen_event in
order to prevent a lists:concat([...,pid()]) crash when
calling sys:get_status/1 on an unregistered gen_event
process.</p>
<p>
Refactor format_status header code from gen_* behaviours
to module gen.</p>
<p>
Extend the format_status tests in gen_event_SUITE to
cover format_status bugs with anonymous gen_event
processes. (Thanks To Geoff Cant)</p>
<p>
Own Id: OTP-9218</p>
</item>
<item>
<p>
List of pids changed to 'set' in supervisor for dynamic
temporary children. Accessing the list would not scale
well when adding/deleting many children. (Thanks to
Evgeniy Khramtsov)</p>
<p>
Own Id: OTP-9242</p>
</item>
<item>
<p>
Change pool module to attempt to attach to nodes that are
already running</p>
<p>
The pool module prints out an error message and takes no
further action for nodes that are already running. This
patch changes that behavior so that if the return from
slave:start/3 is {already_running, Node} then an attempt
to attach to the node is still made. This makes sense
because the node has been specified by the user in the
.hosts.erlang file indicating a wish for the node to be
part of the pool and a manual attach can be successfully
made after the pool is started.(Thanks to Kelly
McLaughlin)</p>
<p>
Own Id: OTP-9244</p>
</item>
<item>
<p>
unicode: document 16#FFFE and 16#FFFF (non chars)(Thanks
to Tuncer Ayaz)</p>
<p>
Own Id: OTP-9256</p>
</item>
<item>
<p>
re: remove gratuitous "it " in manpage (Thanks to Tuncer
Ayaz)</p>
<p>
Own Id: OTP-9307</p>
</item>
<item>
<p> A bug in erl_eval(3) has been fixed. </p>
<p>
Own Id: OTP-9322</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Add <c>timer:tc/1</c> and remove the catch in <c>tc/2</c>
and <c>tc/3</c>. The time measuring functions will thus
no longer trap exits, errors or throws caused by the
measured function.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-9169</p>
</item>
<item>
<p>
Allow supervisor:terminate_child(SupRef,Pid) for
simple_one_for_one supervisors</p>
<p>
supervisor:terminate_child/2 was earlier not allowed if
the supervisor used restart strategy simple_one_for_one.
This is now changed so that children of this type of
supervisors can be terminated by specifying the child's
Pid.</p>
<p>
(Thanks to Vance Shipley.)</p>
<p>
Own Id: OTP-9201</p>
</item>
<item>
<p> Types and specifications have been added. </p>
<p>
Own Id: OTP-9267</p>
</item>
<item>
<p> Erlang types and specifications are used for
documentation. </p>
<p>
Own Id: OTP-9271</p>
</item>
<item>
<p>Allow Dets tablenames to be arbitrary terms.</p>
<p>
Own Id: OTP-9282</p>
</item>
<item>
<p> A specification that could cause problems for
Dialyzer has been fixed. An opaque type in erl_eval has
been turned in to a ordinary type. This is a temporary
fix. </p>
<p>
Own Id: OTP-9333</p>
</item>
</list>
</section>
</section>
<section><title>STDLIB 1.17.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Two bugs in io:format for ~F.~Ps has been corrected. When
length(S) >= abs(F) > P, the precision P was incorrectly
ignored. When F == P > lenght(S) the result was
incorrectly left adjusted. Bug found by Ali Yakout who
also provided a fix.</p>
<p>
Own Id: OTP-8989 Aux Id: seq11741 </p>
</item>
<item>
<p>Fix exception generation in the io module
<p>
Some functions did not generate correct badarg exception
on a badarg exception.</p></p>
<p>
Own Id: OTP-9045</p>
</item>
<item>
<p>
Fixes to the dict and orddict module documentation</p>
<p>
Fixed grammar and one inconsistency (Key - Value instead
of key/value, since everywhere else the former is used).
(thanks to Filipe David Manana)</p>
<p>
Own Id: OTP-9083</p>
</item>
<item>
<p>
Add ISO week number calculation functions to the calendar
module in stdlib</p>
<p>
This new feature adds the missing week number function to
the calendar module of the stdlib application. The
implementation conforms to the ISO 8601 standard. The new
feature has been implemented tested and documented
(thanks to Imre Horvath).</p>
<p>
Own Id: OTP-9087</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Implement the 'MAY' clauses from RFC4648 regarding the
pad character to make mime_decode() and
mime_decode_to_string() functions more tolerant of badly
padded base64. The RFC is quoted below for easy
reference.</p>
<p>
"RFC4648 Section 3.3 with reference to MIME decoding:
Furthermore, such specifications MAY ignore the pad
character, "=", treating it as non-alphabet data, if it
is present before the end of the encoded data. If more
than the allowed number of pad characters is found at the
end of the string (e.g., a base 64 string terminated with
"==="), the excess pad characters MAY also be ignored."</p>
<p>
Own Id: OTP-9020</p>
</item>
<item>
<p>
Supervisors will no longer save start parameters for
temporary processes as they will not be restarted. In the
case of simple_one_for_one workers such as ssl-connection
processes this will substantial reduce the memory
footprint of the supervisor.</p>
<p>
Own Id: OTP-9064</p>
</item>
<item>
<p>
When running escript it is now possible to add the -n
flag and the escript will be compiled using +native.</p>
<p>
Own Id: OTP-9076</p>
</item>
</list>
</section>
</section>