commons-io/src/changes/changes.xml at 9ff22e2c19c996bbe1fd392e10e73031093c7247 · apache/commons-io · GitHub

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"?>
<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You 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

      https://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.
-->

<!--
This file is used by the maven-changes-plugin to generate the release notes.
Useful ways of finding items to add to this file are:

1.  Add items when you fix a bug or add a feature (this makes the
release process easy :-).

2.  Do a Jira search for tickets closed since the previous release.

3.  Use the report generated by the maven-changelog-plugin to see all
CVS commits.  Set the project.properties' maven.changelog.range
property to the number of days since the last release.


To generate the release notes from this file:

mvn changes:announcement-generate -Prelease-notes [-Dchanges.version=nnn]

then tweak the source formatting if necessary and regenerate, then commit

The <action> type attribute can be add,update,fix,remove.
-->
<document xmlns="http://maven.apache.org/changes/2.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/changes/2.0.0 https://maven.apache.org/xsd/changes-2.0.0.xsd">
  <properties>
    <title>Apache Commons IO Release Notes</title>
  </properties>
  <body>
    <release version="2.21.0" date="YYYY-MM-DD" description="Version 2.21.0: Java 8 or later is required.">
      <!-- FIX -->
      <action type="fix" dev="ggregory"                due-to="Gary Gregory">When testing on Java 21 and up, enable -XX:+EnableDynamicAgentLoading.</action>
      <action type="fix" dev="ggregory"                due-to="Gary Gregory">When testing on Java 24 and up, don't fail FileUtilsListFilesTest for a different behavior in the JRE.</action>
      <action type="fix" dev="ggregory"                due-to="Stanislav Fort, Gary Gregory">ValidatingObjectInputStream does not validate dynamic proxy interfaces.</action>
      <action type="fix" dev="pkarwasz"                due-to="Piotr P. Karwasz">BoundedInputStream.getRemaining() now reports Long.MAX_VALUE instead of 0 when no limit is set.</action>
      <action type="fix" dev="pkarwasz"                due-to="Piotr P. Karwasz">BoundedInputStream.available() correctly accounts for the maximum read limit.</action>
      <action type="fix" dev="ggregory"                due-to="Gary Gregory, Piotr P. Karwasz">Deprecate IOUtils.readFully(InputStream, int) in favor of toByteArray(InputStream, int).</action>
      <action type="fix" dev="pkarwasz"                due-to="Piotr P. Karwasz">IOUtils.toByteArray(InputStream) now throws IOException on byte array overflow.</action>
      <!-- ADD -->
      <action dev="ggregory" type="add"                due-to="strangelookingnerd, Gary Gregory">FileUtils#byteCountToDisplaySize() supports Zettabyte, Yottabyte, Ronnabyte and Quettabyte #763.</action>
      <action dev="ggregory" type="add"                due-to="strangelookingnerd, Gary Gregory">Add org.apache.commons.io.FileUtils.ONE_RB #763.</action>
      <action dev="ggregory" type="add"                due-to="strangelookingnerd, Gary Gregory">Add org.apache.commons.io.FileUtils.ONE_QB #763.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add org.apache.commons.io.output.ProxyOutputStream.writeRepeat(byte[], int, int, long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add org.apache.commons.io.output.ProxyOutputStream.writeRepeat(byte[], long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add org.apache.commons.io.output.ProxyOutputStream.writeRepeat(int, long).</action>
      <action dev="pkarwasz" type="add"                due-to="Piotr P. Karwasz">Add length unit support in FileSystem limits.</action>
      <action dev="pkarwasz" type="add"                due-to="Piotr P. Karwasz">Add IOUtils.toByteArray(InputStream, int, int) for safer chunked reading with size validation.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add org.apache.commons.io.file.PathUtils.getPath(String, String).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add org.apache.commons.io.channels.ByteArraySeekableByteChannel.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOIterable.asIterable().</action>
      <action dev="pkarwasz" type="add"                due-to="Piotr P. Karwasz">Add NIO channel support to `AbstractStreamBuilder`.</action>
      <action dev="pkarwasz" type="add"                due-to="Piotr P. Karwasz">Add CloseShieldChannel to close-shielded NIO Channels #786.</action>
      <!-- UPDATE -->
      <action type="update" dev="ggregory"             due-to="Gary Gregory, Dependabot">Bump org.apache.commons:commons-parent from 85 to 88 #774, #783.</action>
      <action type="update" dev="ggregory"             due-to="Gary Gregory">[test] Bump commons-codec:commons-codec from 1.18.0 to 1.19.0.</action>
      <action type="update" dev="ggregory"             due-to="Gary Gregory, Dependabot">[test] Bump commons.bytebuddy.version from 1.17.6 to 1.17.7 #769.</action>
      <action type="update" dev="ggregory"             due-to="Gary Gregory">[test] Bump org.apache.commons:commons-lang3 from 3.18.0 to 3.19.0.</action>
      <!-- REMOVE -->
      <action type="remove" dev="pkarwasz"             due-to="Piotr P. Karwasz">Inline private constant field ProxyInputStream.exceptionHandler #780.</action>
  </release>
    <release version="2.20.0" date="2025-07-13" description="Version 2.20.0: Java 8 or later is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix"                due-to="Jesse Glick">[javadoc] Rename parameter of ProxyOutputStream.write(int) #740.</action>
      <action dev="ggregory" type="fix" issue="IO-875" due-to="Pierre Baumard, Gary Gregory">CopyDirectoryVisitor ignores fileFilter #743.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.getReader(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.AbstractRandomAccessFileOrigin.getReader(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.ByeArrayOrigin.getReader(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.InputStreamOrigin.getReader(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.getWriter(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.AbstractRandomAccessFileOrigin.getWriter(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">org.apache.commons.io.build.AbstractOrigin.OutputStreamOrigin.getWriter(Charset) now maps a null Charset to the default Charset.</action>
      <action dev="ggregory" type="fix"                due-to="Ryan Kurtz, Gary Gregory">FileUtils.readLines(File, Charset) now maps a null Charset to the default Charset #744.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashCr" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.WindowsLineEndingInputStream, org.apache.commons.io.input.WindowsLineEndingInputStream] At WindowsLineEndingInputStream.java:[line 77]Another occurrence at WindowsLineEndingInputStream.java:[line 81] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashCr" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.WindowsLineEndingInputStream] At WindowsLineEndingInputStream.java:[line 112] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashLf" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.WindowsLineEndingInputStream] At WindowsLineEndingInputStream.java:[line 113] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashLf" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.UnixLineEndingInputStream] At UnixLineEndingInputStream.java:[line 75] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atEos" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.UnixLineEndingInputStream] At UnixLineEndingInputStream.java:[line 120] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashCr" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.UnixLineEndingInputStream] At UnixLineEndingInputStream.java:[line 124] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "atSlashLf" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.UnixLineEndingInputStream] At UnixLineEndingInputStream.java:[line 125] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "closed" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.ProxyInputStream] At ProxyInputStream.java:[line 233] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix SpotBugs [ERROR] Medium: Shared primitive variable "propagateClose" in one thread may not yield the value of the most recent write from another thread [org.apache.commons.io.input.BoundedInputStream] At BoundedInputStream.java:[line 555] AT_STALE_THREAD_WRITE_OF_PRIMITIVE.</action>
      <action dev="ggregory" type="fix"                due-to="maxxedev, Piotr P. Karwasz, Gary Gregory">QueueInputStream reads all but the first byte without waiting. #748.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Javadoc fixes and improvements.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NPE in org.apache.commons.io.filefilter.WildcardFilter.accept(File).</action>
      <action dev="ggregory" type="fix" issue="IO-874" due-to="Andy Russell, Joerg Budischewski">FileUtils.forceDelete can delete a broken symlink again #756.</action>
      <action dev="ggregory" type="fix"                due-to="Alex Benusovich">Fix infinite loop in AbstractByteArrayOutputStream. #758.</action>
      <!-- ADD -->
      <action dev="ggregory" type="add" issue="IO-875" due-to="Pierre Baumard, Gary Gregory">Add org.apache.commons.io.file.CountingPathVisitor.accept(Path, BasicFileAttributes) #743.</action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">Add org.apache.commons.io.Charsets.isAlias(Charset, String).</action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">Add org.apache.commons.io.Charsets.isUTF8(Charset).</action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">Add org.apache.commons.io.Charsets.toCharsetDefault(String, Charset).</action>
      <action dev="ggregory" type="add" issue="IO-279" due-to="Joerg Budischewski, Gary Gregory">Add Tailer ignoreTouch option #757.</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update" due-to="Dependabot, Gary Gregory">Bump commons.bytebuddy.version from 1.17.5 to 1.17.6 #754.</action>
      <action dev="ggregory" type="update" due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 81 to 85.</action>
      <action dev="ggregory" type="update" due-to="Dependabot, Gary Gregory">Bump org.apache.commons:commons-lang3 from 3.17.0 to 3.18.0 #761.</action>
    </release>
    <release version="2.19.0" date="2025-04-08" description="Version 2.19.0: Java 8 or later is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate constructor Counters.Counters() to be private in 4.0.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate constructor Charsets.Charsets() to be private in 4.0.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Pick up maven-antrun-plugin version from parent POM org.apache:apache.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Javadoc is missing its Overview page.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Remove -nouses directive from maven-bundle-plugin. OSGi package imports now state 'uses' definitions for package imports, this doesn't affect JPMS (from org.apache.commons:commons-parent:80).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate DeferredFileOutputStream.getStream() in favor of getOutputStream().</action>
      <action dev="ggregory" type="fix" issue="IO-868" due-to="Julian Reschke, Gary Gregory">Improve Javadoc for a BoundedInputStream builder() throwing IOException.</action>
      <action dev="ggregory" type="fix" issue="IO-868" due-to="Julian Reschke, Gary Gregory">Improve Javadoc for all implementations of AbstractOriginSupplier#get().</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">The Consumer to IOUtils.closeQuietly(Closeable, Consumer) now accepts Exception, not just IOException.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">The Consumer to IOUtils.close(Closeable, IOConsumer) now accepts wrapped Exception, not just IOException.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Use Uncheck.getAsBoolean(IOBooleanSupplier) to avoid boxing and unboxing of boolean values.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid unnecessary boxing and unboxing of long values in FileUtils.sizeOf(File).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid unnecessary boxing and unboxing of int values in UncheckedBufferedReader.read().</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid unnecessary boxing and unboxing of int values in UncheckedFilterInputStream.available() and read().</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid unnecessary boxing and unboxing of int values in UncheckedFilterReader.read().</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">FileChannels.contentEquals(FileChannel, FileChannel, int) can return false when comparing a non-blocking channel.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate FileChannels.contentEquals(FileChannel, FileChannel, int) in favor of FileChannels.contentEquals(SeekableByteChannel, SeekableByteChannel, int).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Improve performance of IOUtils.contentEquals(InputStream, InputStream) by about 13%.</action>
      <action dev="ggregory" type="fix" issue="IO-870" due-to="Gary Gregory">PathUtils.copyFileToDirectory() across file systems #728.</action>
      <action dev="ggregory" type="fix" issue="IO-871" due-to="Éamonn McManus, Gary Gregory">IOUtils.contentEquals is incorrect when InputStream.available under-reports.</action>
      <action dev="ggregory" type="fix" issue="IO-873" due-to="Gary Gregory">java.lang.ArithmeticException: long overflow java.lang.Math.addExact(Math.java:932) at org.apache.commons.io.file.attribute.FileTimes.ntfsTimeToFileTime(FileTimes.java:164). See also https://issues.apache.org/jira/browse/MDEP-978.</action>
      <action dev="ggregory" type="fix" issue="IO-873" due-to="Gary Gregory">java.lang.ArithmeticException: long overflow java.lang.Math.addExact(Math.java:932) at org.apache.commons.io.file.attribute.FileTimes.ntfsTimeToDate(long).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">FileTimes.toNtfsTime(*) methods can overflow result values.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix Javadoc for ChunkedOutputStream.Builder.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">General Javadoc improvements.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Calling QueueInputStream.QueueInputStream(null) maps to the same kind of default blocking queue as QueueInputStream.Builder.setBlockingQueue(null).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">CopyDirectoryVisitor creates incorrect file names when copying between different file systems that use different file system separators ("/" versus "\"); fixes PathUtils.copyDirectory(Path, Path, CopyOption...).</action>
      <action dev="ggregory" type="fix"                due-to="zhouchongwen, Gary Gregory">ThreadUtils.sleep(Duration) should handle the underlying OS time changing.</action>
      <!-- ADD -->
      <action dev="ggregory" type="add" issue="IO-860" due-to="Nico Strecker, Gary Gregory">Add ThrottledInputStream.Builder.setMaxBytes(long, ChronoUnit).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOIterable.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">ReversedLinesFileReader implements IOIterable&lt;String&gt;.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractByteArrayOutputStream.write(CharSequence, Charset).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractByteArrayOutputStream.write(byte[]).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileOutputStream.getRandomAccessFile().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ProxyInputStream.setReference(InputStream), was package-private setIn(InputStream).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ProxyOutputStream.setReference(OutputStream).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileInputStream.copy(long, long, OutputStream).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ProxyOutputStream.Builder.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ByteOrderMark.matches(int[]).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add BrokenOutputStream.BrokenOutputStream(Function&lt;String&gt;, Throwable>) and deprecate Supplier&lt;String&gt; constructor.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOBooleanSupplier.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add Uncheck.getAsBoolean(IOBooleanSupplier).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileChannels.contentEquals(SeekableByteChannel, SeekableByteChannel, int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileChannels.contentEquals(ReadableByteChannel, ReadableByteChannel, int).</action>
      <action dev="ggregory" type="add" issue="IO-872" due-to="Gary Gregory">Add SimplePathVisitor.AbstractBuilder.</action>
      <action dev="ggregory" type="add" issue="IO-872" due-to="Gary Gregory">Add CountingPathVisitor.AbstractBuilder and CountingPathVisitor.Builder.</action>
      <action dev="ggregory" type="add" issue="IO-872" due-to="Gary Gregory">Add AccumulatorPathVisitor.Builder and builder().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add PathUtils.contentEquals(FileSystem, FileSystem).</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update"             due-to="Dependabot, Gary Gregory">Bump commons.bytebuddy.version from 1.15.10 to 1.17.5 #710, #715, #720, #734, #735.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump commons-codec:commons-codec from 1.17.1 to 1.18.0. #717.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 78 to 81.</action>
    </release>
    <release version="2.18.0" date="2024-11-16" description="Version 2.18.0: Java 8 is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Clean ups in unit tests.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix some Javadoc issues.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">RandomAccessFileMode.toString() is more helpful for debugging when it inherits from Enum.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix implicit narrowing conversion in compound assignment in UnsynchronizedBufferedReader.skip(long).</action>
      <action dev="ggregory" type="fix" issue="IO-860" due-to="Stefan Feenstra, Gary Gregory">Missing reserved file names in FileSystem.WINDOWS (superscript digits for COM and LPT).</action>
      <action dev="ggregory" type="fix" issue="IO-856" due-to="Thomas Hartwig, Gary Gregory">FileUtils.listFiles(final File, String[], boolean) can throw NoSuchFileException #697, #699.</action>
      <action dev="ggregory" type="fix" issue="IO-859" due-to="JD Dean, Gary Gregory">FileUtils.forceDelete on non-existent file on Windows throws IOException rather than FileNotFoundException.</action>
      <action dev="ggregory" type="fix"                due-to="Éamonn McManus">Use Unicode escapes for superscript characters. #701.</action>
      <action dev="ggregory" type="fix" issue="IO-863" due-to="Éamonn McManus, Gary Gregory">Recent incompatible change to FileUtils.listFiles re extensions, see also IO-856.</action>
      <action dev="ggregory" type="fix" issue="IO-857" due-to="Dmitry, Gary Gregory">Javadoc: Update details for PathUtils "clean" behavior.</action>
      <!-- ADD -->
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add @FunctionalInterface to ClassNameMatcher.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ValidatingObjectInputStream.Builder and ValidatingObjectInputStream.builder().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add a "Safe Deserialization" section to the User Guide for the site.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IORandomAccessFile.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileMode.io(String).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileAlterationObserver.Builder() and deprecate most constructors.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOUtils.readLines(CharSequence).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ValidatingObjectInputStream.ObjectStreamClassPredicate to allow configuration reuse.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileMode.accept(Path, IOConsumer&lt;RandomAccessFile&gt;).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileMode.apply(Path, IOFunction&lt;RandomAccessFile&gt;, T).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOIntConsumer.</action>
      <action dev="ggregory" type="add" issue="IO-861" due-to="Gary Gregory">Add ProxyInputStream.AbstractBuilder. Supports setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to AutoCloseInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to BOMInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add" issue="IO-861" due-to="Gary Gregory">Add support to BoundedInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add" issue="IO-861" due-to="Gary Gregory">Add support to BoundedInputStream for setting a consumer for BoundedInputStream.onMaxLength(long, long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to ChecksumInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to ThrottledInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to ObservableInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to MessageDigestCalculatingInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add support to MessageDigestInputStream for setting a consumer for ProxyInputStream.afterRead(int).</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 74 to 78 #670, #676, #679, #688.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump commons.bytebuddy.version from 1.15.1 to 1.15.10 #672, #673, #685, #686, #694, #696, #698.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Update AbstractStreamBuilder getters from protected to public.</action>
    </release>
    <release version="2.17.0" date="2024-09-15" description="Version 2.17.0: Java 8 is required.">
      <!-- ADD -->
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOIterator.adapt(Iterable).</action>
      <action dev="ggregory" type="add" issue="IO-831" due-to="Elliotte Rusty Harold, Thach Le, Gary Gregory">Add getInputStream() for 'https' and 'http' in URIOrigin #630.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IOSupplier.getUnchecked().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add CloseShieldInputStream.systemIn(InputStream).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add NullInputStream.init().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractInputStream and refactor duplicate code.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add UnsynchronizedReader.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add UnsynchronizedBufferedReader.</action>
      <!-- FIX -->
      <action dev="sebb" type="fix" issue="IO-858">FileUtilsWaitForTest does not test anything useful.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Add missing unit tests.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">FileUtils.lastModifiedFileTime(File) calls Objects.requireNonNull() on the wrong object.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">PathUtils.deleteOnExit(Path) calls Objects.requireNonNull() on the wrong object.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate LineIterator.nextLine() in favor of next().</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Fix PMD UnnecessaryFullyQualifiedName.</action>
      <action dev="ggregory" type="fix"                due-to="sullis">Add test for CircularByteBuffer clear() #620.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">PathUtils.isPosix(Path, LinkOption...) should return false on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">AutoCloseInputStream(InputStream) uses ClosedInputStream.INSTANCE when its input is null.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in ProxyInputStream.available() when the underlying input stream is null.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in ProxyInputStream.markSupported() when the underlying input stream is null.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in ProxyInputStream.mark(int) when the underlying input stream is null.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BufferedFileChannelInputStream.available() returns 0 before any reads.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BufferedFileChannelInputStream.available() should return 0 instead of -1 at the end of the stream.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BufferedFileChannelInputStream.available() should return 0 when the stream is closed instead of throwing an exception.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">CharSequenceInputStream.available() should return 0 after the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BoundedInputStream.available() should return 0 when the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">CircularInputStream.available() should return 0 when the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">InfiniteCircularInputStream.available() should return 0 when the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">ChecksumInputStream(InputStream, Checksum, long, long) should fail-fast on null Checksum input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate NullInputStream.INSTANCE in favor of constructors.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">NullInputStream.available() should return 0 after the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">MemoryMappedFileInputStream.available() should return 0 after the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">RandomAccessFileInputStream.available() should return 0 after the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">ReaderInputStream.available() should return 0 after the stream is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">AutoCloseInputStream does not call handleIOException() on close() when the proxied stream throws an IOException.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BoundedInputStream does not call handleIOException() on close() when the proxied stream throws an IOException.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">NullInputStream.read(*) should throw IOException when it is closed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">NullInputStream.read(byte[]) should return 0 when the input byte array in length 0.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">NullInputStream.read(byte[], int, int) should return 0 when the input byte array in length 0 or requested length is 0.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">MarkShieldInputStream.read(*) should throw IOException when it is closed.</action>
      <action dev="ggregory" type="fix"                due-to="aelaort">Replace deprecated constant FileFileFilter.FILE in Javadoc #657.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Pick up exec-maven-plugin version from parent POM.</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump tests commons.bytebuddy.version from 1.14.13 to 1.15.1 #615, #621, #631, #635, #642, #658, #663, #665.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump tests commons-codec:commons-codec from 1.16.1 to 1.17.1 #644.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump org.codehaus.mojo:exec-maven-plugin from 3.2.0 to 3.4.1 #632, #652, #659.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump org.apache.commons:commons-parent from 69 to 74 #628, #637, #649, #661, #664.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump org.apache.commons:commons-lang3 from 3.14.0 to 3.17.0 #645, #653, #666.</action>
    </release>
    <release version="2.16.1" date="2024-04-04" description="Java 8 is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Reimplement FileSystemUtils using NIO.</action>
      <action dev="ggregory" type="fix" issue="IO-851" due-to="Sebb, Gary Gregory">FileSystemUtils no longer throws IllegalStateException.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid possible NullPointerException in FileUtils.listAccumulate(File, IOFileFilter, IOFileFilter, FileVisitOption...).</action>
      <action dev="ggregory" type="fix" issue="IO-853" due-to="Mike Drob, Gary Gregory">BoundedInputStream.reset() not updating count.</action>
      <action dev="ggregory" type="fix" issue="IO-854" due-to="rproserpio, Bill Orpet, Gary Gregory">ThresholdingOutputStream: a negative threshold should behave like a zero threshold and trigger the event on the first write #609.</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump commons.bytebuddy.version from 1.14.12 to 1.14.13 #605.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory, Dependabot">Bump org.apache.commons:commons-parent from 67 to 69 #608.</action>
    </release>
    <release version="2.16.0" date="2024-03-25" description="Java 8 is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix" due-to="Elliotte Rusty Harold">Fix and re-enable testSkip_RequiredCharsets #518.</action>
      <action dev="ggregory" type="fix" issue="IO-824" due-to="Miguel Munoz, Gary Gregory">SymbolicLineFileFilter documentation fixes.</action>
      <action dev="ggregory" type="fix" issue="IO-795" due-to="Miguel Munoz, Gary Gregory">CharSequenceInputStream.reset() only works once #520.</action>
      <action dev="ggregory" type="fix" issue="IO-795" due-to="Elliotte Rusty Harold">Finish TODO on CharSequenceInputStream #540.</action>
      <action dev="ggregory" type="fix" issue="IO-825" due-to="Arthur Chan, Gary Gregory">Add byte array size validation for methods in EndianUtils #521.</action>
      <action dev="ggregory" type="fix" issue="IO-825" due-to="dkdal, Gary Gregory">Add missing test case CircularByteBufferTest.</action>
      <action dev="ggregory" type="fix" issue="IO-781" due-to="Elliotte Rusty Harold">Make CharSequenceInputStream.available() more correct in the face of multibyte encodings #525.</action>
      <action dev="ggregory" type="fix" issue="IO-781" due-to="Elliotte Rusty Harold">Remove unreachable code in AbstractIOFileFilterTest #526.</action>
      <action dev="ggregory" type="fix" issue="IO-808" due-to="Elliotte Rusty Harold">Rationalize and unify checking for existence of files and directories #529.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in IOCase.checkEquals(String, String) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanExecuteFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanExecuteFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanReadFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanReadFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanWriteFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in CanWriteFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in DirectoryFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in DirectoryFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in EmptyFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in EmptyFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in FileFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in FileFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in HiddenFileFilter.accept(File) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in HiddenFileFilter.accept(Path, BasicFileAttributes) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in IOCase.checkIndexOf(String, int, String) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Avoid NullPointerException in IOCase.checkRegionMatches(String, int, String) on null input.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">BoundedInputStream.getCount() should not count EOF.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold, Gary Gregory">Modernize temporary file creation and deletion in DeferredFileOutputStreamTest #535.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Add PathMatcher to IOFileFilter class Javadoc #536.</action>
      <action dev="ggregory" type="fix" issue="IO-781" due-to="Marcono1234">Fix CharSequenceInputStream coding exception handling #537.</action>
      <action dev="ggregory" type="fix" issue="IO-781" due-to="Marcono1234">Deprecate int CountingInputStream#getCount() in favor of long CountingInputStream#getByteCount().</action>
      <action dev="ggregory" type="fix" issue="IO-828" due-to="Elliotte Rusty Harold, Gary Gregory">Deprecate CountingInputStream.resetCount() in favor of resetByteCount().</action>
      <action dev="ggregory" type="fix" issue="IO-828" due-to="Gary Gregory">Deprecate CountingInputStream.getMaxLength() in favor of getMaxCount()).</action>
      <action dev="ggregory" type="fix" issue="IO-818" due-to="Gary Gregory">NullInputStream breaks InputStream's read method contract.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Javadoc shouldn't reference 1.x behavior #539.</action>
      <action dev="ggregory" type="fix" issue="IO-829" due-to="Elliotte Rusty Harold, Gary Gregory">Don't decode and reencode characters in a potentially different charset in AbstractOrigin.CharSequenceOrigin.getReader(Charset).</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Let subclasses of CountingInputStream.afterRead(int) throw IOException.</action>
      <action dev="ggregory" type="fix" issue="IO-807" due-to="Elliotte Rusty Harold, Gary Gregory">Characterization test for broken symlinks when copying directories #547.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">ClosedInputStream.read(byte[], int, int) does not always return -1.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">ClosedOutputStream.write(byte[], int, int) does not always throw IOException.</action>
      <action dev="ggregory" type="fix"                due-to="Sylwester Lachiewicz, Gary Gregory">XmlStreamReader can't parse an XML document with a multi-line prolog #550.</action>
      <action dev="ggregory" type="fix"                due-to="Andreas Hubold, Gary Gregory">XmlStreamReader can't parse XML an document with an external parsed entity prolog.</action>
      <action dev="ggregory" type="fix" issue="IO-836" due-to="Elliotte Rusty Harold">Update FileNameUtils Javadoc #554.</action>
      <action dev="ggregory" type="fix" issue="IO-807" due-to="Jordi Sola, Elliotte Rusty Harold">Copy symlinks, not the files the symlinks point to #558.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Pickup apache-rat-plugin version from parent POM.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Add test for copying a symlink FileUtilsTest#testCopyFile_symLink() #564.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Make copyFile copy symbolic links by value rather than reference #565.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate CopyUtils 0-argument constructor.</action>
      <action dev="ggregory" type="fix" issue="IO-843" due-to="Gary Gregory, Elliotte Rusty Harold">Deprecate EndianUtils 0-argument constructor.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate FileSystemUtils 0-argument constructor.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate FilenameUtils 0-argument constructor.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate RandomAccessFiles 0-argument constructor.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold, Gary Gregory">Clarify and correct EndianUtils and SwappedDataInputStream API doc #566.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Add characterization test for copying a symlinked directory #570.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">RandomAccessFileInputStream.builder().get() now throws ISE instead of NPE.</action>
      <action dev="ggregory" type="fix" issue="IO-845" due-to="Elliotte Rusty Harold">Test links to targets outside the source directory #571.</action>
      <action dev="ggregory" type="fix"                due-to="Elliotte Rusty Harold">Focus Javadoc on current version rather than past versions #573, #574.</action>
      <action dev="ggregory" type="fix" issue="IO-469" due-to="Grigory Fadeev, Kristian Rosenvold, Elliotte Rusty Harold">"Self-suppression not permitted" while using BrokenOutput and BrokenInput streams with try-with-resources.</action>
      <action dev="ggregory" type="fix" issue="IO-405" due-to="Elliotte Rusty Harold">Handle zero and negative thresholds #587.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">Deprecate CountingInputStream in favor of BoundedInputStream.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">PathUtils.setPosixPermissions(...) only sets permissions if needed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">PathUtils.setReadOnly(...) only sets permissions if needed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">PathUtils.deleteFile(..., DeleteOption...) only sets permissions if needed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">CleaningPathVisitor only sets permissions if needed.</action>
      <action dev="ggregory" type="fix"                due-to="Gary Gregory">DeletingPathVisitor only sets permissions if needed.</action>
      <!-- Add -->
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add and use PathUtils.getFileName(Path, Function&lt;Path, R&gt;).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add and use PathUtils.getFileNameString().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Make public Erase.rethrow(Throwable).</action>
      <action dev="ggregory" type="add" issue="IO-826" due-to="markslater, Gary Gregory">Add BrokenInputStream.BrokenInputStream(Throwable).</action>
      <action dev="ggregory" type="add" issue="IO-826" due-to="markslater, Gary Gregory">Add BrokenReader.BrokenReader(Throwable).</action>
      <action dev="ggregory" type="add" issue="IO-826" due-to="markslater, Gary Gregory">Add BrokenOutputStream.BrokenOutputStream(Throwable).</action>
      <action dev="ggregory" type="add" issue="IO-826" due-to="markslater, Gary Gregory">Add BrokenWriter.BrokenWriter(Throwable).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add BoundedInputStream.getRemaining().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.toNtfsTime(long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.fromUnixTime(long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.isUnixTime(FileTime).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.isUnixTime(long).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.toUnixTime(FileTime).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add BrokenInputStream.Builder.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add PathUtils.getExtension(Path).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add PathUtils.getBaseName(Path).</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ThrottledInputStream.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add IORunnable.noop().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ChecksumInputStream and test #548.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractStreamBuilder.getReader().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add Maven property project.build.outputTimestamp for build reproducibility.</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ProxyInputStream.unwrap().</action>
      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add a running count and builder to BoundedInputStream.</action>
      <!--  UPDATE -->
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump commons.bytebuddy.version from 1.14.10 to 1.14.12 #534, #592.</action>
      <action dev="ggregory" type="update"             due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 65 to 67.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump commons-codec:commons-codec from 1.16.0 to 1.16.1 #583.</action>
      <action dev="ggregory" type="update"             due-to="Dependabot">Bump org.codehaus.mojo:exec-maven-plugin from 3.1.1 to 3.2.0 #593.</action>
    </release>
    <release version="2.15.1" date="2023-11-24" description="Java 8 is required.">
      <!-- FIX -->
      <action dev="sebb" type="fix" due-to="Gregor Dschung">Fix wrong issue id in change log #503.</action>
      <action dev="ggregory" type="fix" due-to="Stephan Markwalder, Gary Gregory">Add test for FileChannels.contentEquals() #509.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix FileChannels.contentEquals().</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix some Javadoc issues in LineIterator and IOUtils.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Simplify FileAlterationObserver internal processing.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Avoid NullPointerException in RegexFileFilter.RegexFileFilter(Pattern).</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Avoid NullPointerException in RegexFileFilter.accept(Path, BasicFileAttributes).</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Class org.apache.commons.io.filefilter.RegexFileFilter defines non-transient non-serializable instance field pathToString [org.apache.commons.io.filefilter.RegexFileFilter] In RegexFileFilter.java SE_BAD_FIELD.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Class org.apache.commons.io.filefilter.DelegateFileFilter defines non-transient non-serializable instance field fileFilter [org.apache.commons.io.filefilter.DelegateFileFilter] In DelegateFileFilter.java SE_BAD_FIELD.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Class org.apache.commons.io.filefilter.DelegateFileFilter defines non-transient non-serializable instance field fileNameFilter [org.apache.commons.io.filefilter.DelegateFileFilter] In DelegateFileFilter.java SE_BAD_FIELD.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.function.IOStream$1.next() cannot throw NoSuchElementException [org.apache.commons.io.function.IOStream$1] At IOStream.java:[line 98] IT_NO_SUCH_ELEMENT.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.monitor.FileAlterationMonitor.getObservers() may expose internal representation by returning FileAlterationMonitor.observers [org.apache.commons.io.monitor.FileAlterationMonitor] At FileAlterationMonitor.java:[line 124] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Class org.apache.commons.io.monitor.FileAlterationObserver defines non-transient non-serializable instance field fileFilter [org.apache.commons.io.monitor.FileAlterationObserver] In FileAlterationObserver.java SE_BAD_FIELD.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Class org.apache.commons.io.monitor.FileAlterationObserver defines non-transient non-serializable instance field listeners [org.apache.commons.io.monitor.FileAlterationObserver] In FileAlterationObserver.java SE_BAD_FIELD.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.FileCleaningTracker.getDeleteFailures() may expose internal representation by returning FileCleaningTracker.deleteFailures [org.apache.commons.io.FileCleaningTracker] At FileCleaningTracker.java:[line 218] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.IOExceptionList.getCauseList() may expose internal representation by returning IOExceptionList.causeList [org.apache.commons.io.IOExceptionList] At IOExceptionList.java:[line 118] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.IOExceptionList.getCauseList(Class) may expose internal representation by returning IOExceptionList.causeList [org.apache.commons.io.IOExceptionList] At IOExceptionList.java:[line 129] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.file.AccumulatorPathVisitor.getDirList() may expose internal representation by returning AccumulatorPathVisitor.dirList [org.apache.commons.io.file.AccumulatorPathVisitor] At AccumulatorPathVisitor.java:[line 179] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.file.AccumulatorPathVisitor.getFileList() may expose internal representation by returning AccumulatorPathVisitor.fileList [org.apache.commons.io.file.AccumulatorPathVisitor] At AccumulatorPathVisitor.java:[line 188] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: org.apache.commons.io.input.ObservableInputStream.getObservers() may expose internal representation by returning ObservableInputStream.observers [org.apache.commons.io.input.ObservableInputStream] At ObservableInputStream.java:[line 187] EI_EXPOSE_REP.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Exception thrown in class org.apache.commons.io.input.UnsynchronizedByteArrayInputStream at new org.apache.commons.io.input.UnsynchronizedByteArrayInputStream(byte[], int) will leave the constructor. The object under construction remains partially initialized and may be vulnerable to Finalizer attacks. [org.apache.commons.io.input.UnsynchronizedByteArrayInputStream, org.apache.commons.io.input.UnsynchronizedByteArrayInputStream] At UnsynchronizedByteArrayInputStream.java:[line 202]At UnsynchronizedByteArrayInputStream.java:[line 202] CT_CONSTRUCTOR_THROW.</action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">Fix SpotBugs error: Exception thrown in class org.apache.commons.io.input.UnsynchronizedByteArrayInputStream at new org.apache.commons.io.input.UnsynchronizedByteArrayInputStream(byte[], int, int) will leave the constructor. The object under construction remains partially initialized and may be vulnerable to Finalizer attacks. [org.apache.commons.io.input.UnsynchronizedByteArrayInputStream, org.apache.commons.io.input.UnsynchronizedByteArrayInputStream] At UnsynchronizedByteArrayInputStream.java:[line 223]At UnsynchronizedByteArrayInputStream.java:[line 223] CT_CONSTRUCTOR_THROW.</action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update" due-to="Gary Gregory">Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.1.1 #512.</action>
      <action dev="ggregory" type="update" due-to="Gary Gregory">Bump commons-lang3 from 3.13.0 to 3.14.0.</action>
      <action dev="ggregory" type="update" due-to="Dependabot">Bump commons.bytebuddy.version from 1.14.9 to 1.14.10 #516.</action>
      <action dev="ggregory" type="update" due-to="Dependabot">Bump commons-parent from 64 to 65.</action>
    </release>
    <release version="2.15.0" date="2023-10-21" description="Java 8 is required.">
      <!-- FIX -->
      <action dev="sebb" type="fix" issue="IO-815" due-to="Laurence Gonsalves">
        XmlStreamReader encoding match RE is too strict.
      </action>
      <action dev="ggregory" type="fix" issue="IO-810" due-to="Gregor Dschung, Gary Gregory">
        Javadoc in FileUtils does not reflect code for thrown exceptions.
      </action>
      <action dev="ggregory" type="fix" issue="IO-812" due-to="Adam Rauch, Gary Gregory">
        Javadoc should mention closing Streams based on file resources.
      </action>
      <action dev="ggregory" type="fix" issue="IO-811" due-to="Adam Rauch, Gary Gregory">
        In tests, Files.walk() direct and indirect callers fail to close the returned Stream.
      </action>
      <action dev="ggregory" type="fix" issue="IO-811" due-to="Adam Rauch, Gary Gregory">
        FileUtils.listFiles(File, String[], boolean) fails to close its internal Stream.
      </action>
      <action dev="ggregory" type="fix" issue="IO-811" due-to="Adam Rauch, Gary Gregory">
        FileUtils.iterateFiles(File, String[], boolean) fails to close its internal Stream.
      </action>
      <action dev="ggregory" type="fix" issue="IO-811" due-to="Adam Rauch, Gary Gregory">
        StreamIterator fails to close its internal Stream.
      </action>
      <action dev="ggregory" type="fix" issue="IO-814" due-to="Elliotte Rusty Harold, Gary Gregory">
        Don't throw UncheckedIOException #491.
      </action>
      <action dev="ggregory" type="fix" issue="IO-414" due-to="Elliotte Rusty Harold, Gary Gregory">
        Don't write a BOM on every (or any) line #492.
      </action>
      <action dev="ggregory" type="fix" issue="IO-814" due-to="Gary Gregory">
        RandomAccessFileMode.create(Path) provides a better NullPointerException message.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Improve performance of PathUtils.fileContentEquals(Path, Path, LinkOption[], OpenOption[]) by about 60%, see PathUtilsContentEqualsBenchmark.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Improve performance of PathUtils.fileContentEquals(Path, Path) by about 60%, see PathUtilsContentEqualsBenchmark.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Improve performance of FileUtils.contentEquals(File, File) by about 60%, see PathUtilsContentEqualsBenchmark.
      </action>
      <action dev="ggregory" type="fix" due-to="Elliotte Rusty Harold">
        Remove unused test code #494.
      </action>
      <action dev="ggregory" type="fix" due-to="sebbASF">
        [Javadoc] IOUtils#contentEquals does not throw NullPointerException #496.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Fix CodeQL warnings in UnsynchronizedBufferedInputStream: Implicit narrowing conversion in compound assignment.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        MessageDigestCalculatingInputStream.MessageDigestMaintainingObserver.MessageDigestMaintainingObserver(MessageDigest) now throws a NullPointerException
        if the MessageDigest is null.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        MessageDigestCalculatingInputStream.MessageDigestCalculatingInputStream(InputStream, MessageDigest) now throws a NullPointerException
        if the MessageDigest is null.
      </action>
      <action issue="IO-816" dev="ggregory" type="fix" due-to="Andreas Loth, Gary Gregory">
        UnsynchronizedBufferedInputStream.read(byte[], int, int) does not use buffer.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Pick up Maven Moditect plugin version from parent POM.
      </action>
      <action issue="IO-821" dev="ggregory" type="fix" due-to="Frédéric Hannes, Gary Gregory">
        2.15.0 breaks backwards compatibility in PathUtils.fileContentEquals for the Zip file system.
      </action>
      <!-- ADD -->
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add org.apache.commons.io.channels.FileChannels.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add RandomAccessFiles#contentEquals(RandomAccessFile, RandomAccessFile).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add RandomAccessFiles#reset(RandomAccessFile).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtilsContentEqualsBenchmark.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add org.apache.commons.io.StreamIterator.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add MessageDigestInputStream and deprecate MessageDigestCalculatingInputStream.
      </action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update" due-to="Gary Gregory">
        Bump org.apache.commons:commons-parent from 62 to 64.
      </action>
    </release>
    <release version="2.14.0" date="2023-09-24" description="Java 8 is required.">
      <!-- FIX -->
      <action dev="ggregory" type="fix" issue="IO-799" due-to="Jeroen van der Vegt, Gary Gregory">
        ReaderInputStream.read() throws an exception instead of returning -1 when called again after returning -1.
      </action>
      <action dev="ggregory" type="fix" issue="IO-804" due-to="Elliotte Rusty Harold, Gary Gregory">
        FileUtils.forceMkdirParent() Javadoc is incorrect.
      </action>
      <action dev="ggregory" type="fix" due-to="step-security-bot, Gary Gregory">
        [StepSecurity] ci: Harden GitHub Actions #461.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        MagicNumberFileFilter.accept(Path, BasicFileAttributes) doesn't set its byteOffset before reading.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Javadoc improvements.
      </action>
      <action dev="ggregory" type="fix" due-to="Josh Soref, Gary Gregory">
        Spelling #468.
      </action>
      <action dev="ggregory" type="fix" due-to="Jakub Kupczyk">
        Use assertThrows #475.
      </action>
      <!-- ADD -->
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add DeferredFileOutputStream.getPath().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileCleaningTracker.track(Path, Object[, FileDeleteStrategy]).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add IOUtils.skip[Fully](InputStream, long, Supplier&lt;byte[]&gt;).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FilesUncheck.find(Path, int, BiPredicate%lt;Path, BasicFileAttributes&gt;, FileVisitOption...)
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add IOIntSupplier.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add IOLongSupplier.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add Uncheck.getAsInt(IOIntSupplier [, Supplier&lt;String&gt;]).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add Uncheck.getAsLong(IOLongSupplier [, Supplier&lt;String&gt;]).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add Uncheck.run(IORunnable, Supplier&lt;String&gt;)
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add Uncheck.get(IOSupplier, Supplier&lt;String&gt;)
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        IOFileFilter now also extends java.nio.file.PathMatcher.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathMatcherFileFilter to adapt java.nio.file.PathMatcher.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ThresholdingOutputStream.getOutputStream() and deprecate getStream().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add DeferredFileOutputStream.Builder.setOutputFile(Path).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add DeferredFileOutputStream.Builder.setDirectory(Path).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AbstractStreamBuilder.setBufferSizeChecker(IntToIntFunction).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AbstractStreamBuilder.setBufferSizeMax(int).
      </action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update" due-to="Dependabot">
        Bump jimfs from 1.2 to 1.3.0 #465 (tests).
      </action>
      <action dev="ggregory" type="update" due-to="Gary Gregory">
        Bump commons-parent from 58 to 62.
      </action>
      <action type="update" dev="ggregory" due-to="Gary Gregory">
        Bump commons-lang3 from 3.12 to 3.13.0.
      </action>
    </release>
    <release version="2.13.0" date="2023-06-03" description="Java 8 is required.">
      <!-- FIX -->
      <action issue="IO-791" dev="ggregory" type="fix" due-to="Chad Wilson, Gary Gregory">
        Regression in FileUtils.touch() - no longer creates parent directories.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        ByteArrayOrigin should be able convert a byte[] to a ByteArrayInputStream.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        AbstractOriginSupplier.checkOrigin() now throws IllegalStateException instead of NullPointerException.
      </action>
      <action issue="IO-796" dev="ggregory" type="fix" due-to="Giacomo Boccardo, Gary Gregory">
        FileAlreadyExistsException in PathUtils.createParentDirectories(Path, LinkOption, FileAttribute...).
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Only read the relevant portion of a file in AbstractOrigin.FileOrigin.getByteArray(long, int).
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Only read the relevant portion of a file in AbstractOrigin.PathOrigin.getByteArray(long, int).
      </action>
      <action dev="ggregory" type="fix" due-to="Shai Shapira, Gary Gregory" issue="IO-798">
        DeferredFileOutputStream throws exception when system temp dir is a symlink.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        ReaderInputStream.Builder.setCharsetEncoder(null) should reset to a default object, not throw an NPE.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        ReaderInputStream.Builder.setCharset(null) should reset to a default object, not throw an NPE.
      </action>
      <action dev="ggregory" type="fix" issue="IO-800" due-to="Jan Høydahl, Gary Gregory">
        Fix back-incompatible change for PathUtils.deleteDirectory(): throw NoSuchFileException instead of IllegalArgumentException #459.
      </action>
      <action dev="ggregory" type="fix" issue="IO-801" due-to="James Howe, Gary Gregory">
        Deprecation documentation gives incorrect alternative.
      </action>
      <!-- ADD -->
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add CharSequenceInputStream.Builder.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ChunkedOutputStream.Builder.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AbstractStreamBuilder.setOpenOptions(OpenOption...).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add some missing conversions to AbstractOrigin subclasses.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AbstractOrigin.getByteArray(long, int).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use RandomAccessFiles.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AbstractOrigin.size().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.EMPTY_FILE_ATTRIBUTE_ARRAY.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add CharSequenceInputStream.Builder.setCharsetEncoder(CharsetEncoder).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add CharsetEncoders.toCharsetEncoder(CharsetEncoder, Supplier&lt;CharsetEncoder&gt;).
      </action>
      <!-- UPDATE -->
      <action dev="ggregory" type="update" due-to="Gary Gregory, Dependabot">
        Bump commons-parent from 57 to 58.
      </action>
    </release>
    <release version="2.12.0" date="2023-05-13" description="Java 8 is required.">
      <!-- FIX -->
      <action issue="IO-697" dev="kinow" type="fix" due-to="otter606">
        IOUtils.toByteArray size validation does not match documentation.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Fix Javadoc links to the JRE Javadoc 8.
      </action>
      <action issue="IO-744" dev="ggregory" type="fix" due-to="RBRi, Gary Gregory">
        FileWriterWithEncoding for an existing file no longer truncates the file. #251.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        A null Charset or Charset name in FileWriterWithEncoding constructors uses the default Charset.
      </action>
      <action dev="ggregory" type="fix" due-to="Davide Angelocola">
        Fix usage of assertNotNull #269.
      </action>
      <action issue="IO-727" dev="ggregory" type="fix" due-to="trungPa, Gary Gregory">
        FilenameUtils directoryContains() should handle files with the same prefix #217.
      </action>
      <action issue="IO-746" dev="ggregory" type="add" due-to="Davide Angelocola">
        Drop unnecessary casts and conversions #267.
      </action>
      <action issue="IO-748" dev="ggregory" type="fix" due-to="Dirk Heinrichs, Gary Gregory, Elango Ravi">
        FileUtils.moveToDirectory() exception documentation and exception message error.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        ThreadMonitor.sleep(Duration) ignores nanoseconds.
      </action>
      <action dev="ggregory" type="fix" due-to="Arturo Bernal">
        Fix Javadoc in ThreadMonitor#run() method. #273.
      </action>
      <action issue="IO-749" dev="ggregory" type="fix" due-to="haihuiyang, Gary Gregory">
        FileUtils.listFiles() does not list matching files if File parameter is a symbolic link.
      </action>
      <action dev="ggregory" type="fix" due-to="niranjanghule, Gary Gregory">
        Fix typo in Javadocs for FileUtils#convertFileCollectionToFileArray() #276.
      </action>
      <action dev="ggregory" type="fix" due-to="DaGeRe, Gary Gregory">
        Avoid Code Duplication: Reuse Sleep from ThreadMonitor #66.
      </action>
      <action issue="IO-750" dev="ggregory" type="fix" due-to="Sita Geßner, Sebastian Peters, Gary Gregory">
        FileUtils.iterateFiles also lists directories.
      </action>
      <action issue="IO-721" dev="ggregory" type="fix" due-to="Dirk Heinrichs, Gary Gregory">
        Wrong exception message in FileUtils.setLastModified(File, File).
      </action>
      <action issue="IO-717" dev="ggregory" type="fix" due-to="Marcono1234, Gary Gregory">
        Infinite loop in ReaderInputStream instead of throwing exception for CodingErrorAction.REPORT.
      </action>
      <action issue="IO-716" dev="ggregory" type="fix" due-to="Marcono1234, Gary Gregory">
        ReaderInputStream enter infinite loop for too small buffer sizes.
      </action>
      <action issue="IO-638" dev="ggregory" type="fix" due-to="Thayne McCombs, Gary Gregory">
        Infinite loop in CharSequenceInputStream.read for 4-byte characters with UTF-8 and 3-byte buffer.
      </action>
      <action issue="IO-638" dev="ggregory" type="fix" due-to="Gary Gregory">
        PathUtils.setReadOnly(Path, boolean, LinkOption...) should add READ_* file attributes when using POSIX.
      </action>
      <action issue="IO-638" dev="ggregory" type="fix" due-to="Gary Gregory">
        PathUtils.setReadOnly(Path, boolean, LinkOption...) readOnly argument is always assumed true on POSIX.
      </action>
      <action issue="IO-729" dev="ggregory" type="fix" due-to="Rob Spoor, Gary Gregory">
        Prevent IllegalArgumentExceptions in BrokenInputStream/Reader/OutputStream/Writer #278.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        FileUtils.copyURLToFile(URL, File, int, int) leaks its URLConnection.
        Called by FileUtils.copyURLToFile(URL, File).
      </action>
      <action issue="IO-714" dev="ggregory" type="fix" due-to="kevinwang1975, Gary Gregory">
        Fixed ReaderInputStream not calling CharsetEncoder.flush issue #283.
      </action>
      <action dev="ggregory" type="fix" due-to="Arturo Bernal">
        Minor changes #287.
      </action>
      <action issue="IO-756" dev="ggregory" type="fix" due-to="wodencafe, Gary Gregory, Bruno P. Kinoshita">
        Update FileWriterWithEncoding to extend ProxyWriter #296.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Initialize the message of an IOExceptionList to a default if null.
      </action>
      <action issue="IO-751" dev="ggregory" type="fix" due-to="Gary Gregory, Richard Cyganiak">
        When deleting symlinks, File/PathUtils.deleteDirectory() changes file permissions of the target.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        ReaderInputStream maps null Charset, Charset name, and CharsetEncoder to the platform default instead of throwing a NullPointerException.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        CharSequenceInputStream maps null Charset and Charset name to the platform default instead of throwing a NullPointerException.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        WriterOutputStream maps null Charset, Charset name, and CharsetEncoder name to the platform default instead of throwing a NullPointerException.
      </action>
      <action dev="ggregory" type="fix" due-to="Chad Wilson, Gary Gregory">
        FileUtils.copyURLToFile should create target parent directories and overwrite target file #319.
      </action>
      <action issue="IO-484" dev="ggregory" type="fix" due-to="Marcono1234, Gary Gregory">
        Fix incorrect FilenameUtils Javadoc for null bytes #310.
      </action>
      <action issue="IO-484" dev="ggregory" type="fix" due-to="Arturo Bernal">
        Change to uppercase variable constant. #323.
      </action>
      <action issue="IO-484" dev="ggregory" type="fix" due-to="David Huang, Gary Gregory">
        IOCase.isCaseSensitive(IOCase) result is backward #325.
      </action>
      <action issue="IO-758" dev="ggregory" type="fix" due-to="Marcono1234, Gary Gregory">
        Deprecate PathUtils.NOFOLLOW_LINK_OPTION_ARRAY in favor of noFollowLinkOptionArray().
      </action>
      <action dev="ggregory" type="fix" due-to="Marcono1234, Gary Gregory">
        Improve ReaderInputStream documentation #291.
      </action>
      <action dev="ggregory" type="fix" due-to="richarda23">
        Fix misleading comments in FileFilterTest #334.
      </action>
      <action dev="ggregory" type="fix" due-to="Diego Marcilio">
        Add missing Javadoc for exceptions thrown for invalid arguments #339.
      </action>
      <action dev="ggregory" type="fix" due-to="richarda23">
        FileFilterTest minor fixes #340.
      </action>
      <action issue="IO-764" dev="ggregory" type="fix" due-to="DaGeRe, Gary Gregory">
        IOUtils.write() throws OutOfMemoryError/NegativeArraySizeException while writing big strings #343.
      </action>
      <action issue="IO-768" dev="ggregory" type="fix" due-to="Marcono1234, Michael Osipov">
        Add reserved Windows file names CONIN$ and CONOUT$ to FileSystem #355.
      </action>
      <action issue="IO-773" dev="ggregory" type="fix" due-to="Dominik Reinarz, Gary Gregory">
        RegexFileFilter is no longer Serializable.
      </action>
      <action issue="IO-763" dev="ggregory" type="fix" due-to="Richard Adams, Gary Gregory">
        [Javadoc] FileFilterUtils doc does not match impl: missing some file filters.
      </action>
      <action issue="IO-762" dev="ggregory" type="fix" due-to="Leonidas Chiron, Gary Gregory">
        FileSystem.WINDOWS.isReservedFileName doesn't check for file extension.
      </action>
      <action issue="IO-772" dev="ggregory" type="fix" due-to="Dan Ziemba, Gary Gregory">
        Confusing Javadoc on IOUtils#resourceToURL() and other resource* methods.
      </action>
      <action issue="IO-443" dev="ggregory" type="fix" due-to="Dan Ziemba, Gary Gregory">
        FileUtils.copyFile methods throw an unnecessary "Failed to copy full contents from" exception.
      </action>
      <action issue="IO-564" dev="ggregory" type="fix" due-to="Hao Zhong, Bernd Eckenfels, Pascal Schumacher, Gary Gregory">
        Pick up Javadoc from super for override write() methods in AbstractByteArrayOutputStream and ByteArrayOutputStream.
      </action>
      <action dev="ggregory" type="fix" due-to="Marc Wrobel">
        Fix minor typos #367.
      </action>
      <action issue="IO-776" dev="kinow" type="fix" due-to="Chris Povirk">
        Fix parameters to requireNonNull call in DeferredOutputSteam #368.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Fix PathUtils.copyFileToDirectory(URL,Path,CopyOption[]).
      </action>
      <action issue="IO-386" dev="ggregory" type="fix" due-to="Sebb, Bernd Eckenfels, zhipengxu, Gary Gregory">
        FileUtils.doCopyFile uses different methods to check the file sizes.
      </action>
      <action dev="ggregory" type="fix" due-to="Michael Ernst">
        Fix typos #375.
      </action>
      <action issue="IO-611" dev="ggregory" type="fix" due-to="Fedor Urvanov">
        FilenameUtils.normalize javadoc and tests #383.
      </action>
      <action issue="IO-611" dev="ggregory" type="fix" due-to="ArdenL-Liu, Bruno P. Kinoshita, Gary Gregory">
        Better docs in IOUtils and IOUtils.byteArray(int size) #374.
      </action>
      <action issue="IO-782" dev="ggregory" type="fix" due-to="Matteo Di Giovinazzo, Gary Gregory">
        SequenceReader should close readers when its close method is called #391.
      </action>
      <action issue="IO-790" dev="ggregory" type="fix" due-to="Miguel Muñoz, Gary Gregory">
        Fix symbolic link file filter #450.
      </action>
      <action issue="IO-790" dev="ggregory" type="fix" due-to="maxxedev, Gary Gregory, Bruno P. Kinoshita">
        Apply nanoseconds precision for QueueInputStream timeout duration. #453.
      </action>
      <action dev="ggregory" type="fix" due-to="Marcono1234">
        Fix overflow for FileUtilsTest constants #456.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        Serialization is deprecated and will be removed in 3.0.
      </action>
      <action dev="ggregory" type="fix" due-to="Gary Gregory">
        FileSystemUtils.performCommand(String[], int, Duration): Use Locale.getDefault() instead of ENGLISH.
      </action>
      <!-- ADD -->
      <action type="add" dev="ggregory" due-to="Gary Gregory">
        Add GitHub coverage.yml.
      </action>
      <action issue="IO-726" dev="ggregory" type="fix" due-to="shollander, Gary Gregory">
        Add MemoryMappedFileInputStream #215.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add BrokenReader.INSTANCE.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedBufferedReader.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedFilterReader.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedFilterWriter.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedFilterInputStream.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedFilterOutputStream.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add BrokenInputStream.INSTANCE.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ClosedInputStream.INSTANCE and deprecate CLOSED_INPUT_STREAM.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ClosedReader.INSTANCE and deprecate CLOSED_READER.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add BrokenWriter.INSTANCE.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ClosedOutputStream.INSTANCE and deprecate CLOSED_OUTPUT_STREAM.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add ClosedWriter.INSTANCE and deprecate CLOSED_WRITER.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add NullOutputStream.INSTANCE and deprecate NULL_OUTPUT_STREAM.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add NullPrintStream.INSTANCE and deprecate NULL_PRINT_STREAM.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add NullWriter.INSTANCE and deprecate NULL_WRITER.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add NullInputStream.INSTANCE.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add NullReader.INSTANCE.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.readString(Path, Charset).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileUtils.newOutputStream(File, boolean).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.newOutputStream(Path, boolean).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add UncheckedAppendable.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and reuse UncheckedIOExceptions.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.getTempDirectory().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileSystem.getNameSeparator().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileSystem.normalizeSeparators().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.isNewer(Path, FileTime, LinkOption...).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.isNewer(Path, Instant, LinkOption...).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add AgeFileFilter.AgeFileFilter(Instant).
        Add AgeFileFilter.AgeFileFilter(Instant, boolean).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileUtils.lastModifiedFileTime(File).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileTimes.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.waitFor(Path, Duration, LinkOption...).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add org.apache.commons.io.input.Tailer.getDelayDuration().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add FileUtils.current().
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use PathUtils.setLastModifiedTime(Path) for more precision.
        Add and use PathUtils.setLastModifiedTime(Path, Path) for more precision.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use PathUtils.isNewer(Path, ChronoZonedDateTime, LinkOption...) for more precision.
        Add and use PathUtils.isNewer(Path, Path) for more precision.
        Add and use FileUtils.isNewer(File, FileTime) for more precision.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use PathUtils.isOlder(Path, FileTime, LinkOption...).
        Add and use PathUtils.isOlder(Path, Instant, LinkOption...).
        Add and use PathUtils.isOlder(Path, long, LinkOption...).
        Add and use PathUtils.isOlder(Path, Path).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use PathUtils.sizeOf(Path).
        Add and use PathUtils.sizeOfAsBigInteger(Path).
        Add and use PathUtils.sizeOfDirectory(Path).
        Add and use PathUtils.sizeOfDirectoryAsBigInteger(Path).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use IOCase.value(IOCase, IOCase).
      </action>
      <action dev="jonfreedman" type="add" due-to="Jon Freedman, Gary Gregory">
        Add Tailer.Tailable interface to allow tailing of remote files for example using jCIFS.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and use RandomAccessFileMode.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.writeString(Path, CharSequence, Charset, OpenOption...).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtiFiles.getFileAttributeView() shorthands:
          - PathUtils.getAclFileAttributeView(Path, LinkOption...)
          - PathUtils.getDosFileAttributeView(Path, LinkOption...)
          - PathUtils.getPosixFileAttributeView(Path, LinkOption...)
      </action>
      <action issue="IO-747" dev="mgrigorov" type="add">
        Make commons-io a JPMS module by adding module-info.class.
      </action>
      <action issue="IO-753" dev="ggregory" type="add" due-to="SebastianDietrich, Gary Gregory">
        Add IOUtils method to copy output stream to input stream #281.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.isPosix(Path, LinkOption...). #290
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add PathUtils.readAttributes(Path, Class, LinkOption...). #290
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add IOExceptionList.checkEmpty(List, Object).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add IOBiConsumer, IOTriConsumer, IOComparator, IOUnaryOperator, IOBinaryOperator.
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add and reuse IOConsumer forAll(*), forEach(*), and forEachIndexed(*).
      </action>
      <action dev="ggregory" type="add" due-to="Gary Gregory">
        Add CharsetEncoders.
      </action>