From 392cb9ca313665f50af196cc1c26d66bc1ff28ac Mon Sep 17 00:00:00 2001 From: Gary Gregory Date: Sat, 10 Feb 2024 16:31:51 -0500 Subject: [PATCH] Javadoc --- .../compress/archivers/zip/ZipSplitOutputStream.java | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/apache/commons/compress/archivers/zip/ZipSplitOutputStream.java b/src/main/java/org/apache/commons/compress/archivers/zip/ZipSplitOutputStream.java index c1c9ccccff3..17b75ddead1 100644 --- a/src/main/java/org/apache/commons/compress/archivers/zip/ZipSplitOutputStream.java +++ b/src/main/java/org/apache/commons/compress/archivers/zip/ZipSplitOutputStream.java @@ -120,10 +120,13 @@ public void close() throws IOException { *

* 8.3.3 Split ZIP files are typically written to the same location and are subject to name collisions if the spanned name format is used since each segment * will reside on the same drive. To avoid name collisions, split archives are named as follows. + *

*

* Segment 1 = filename.z01 Segment n-1 = filename.z(n-1) Segment n = filename.zip + *

*

* NOTE: The ZIP split segment begin from 1,2,3,... , and we're creating a new segment, so the new segment suffix should be (currentSplitSegmentIndex + 2) + *

* * @param zipSplitSegmentSuffixIndex * @return @@ -214,6 +217,7 @@ public long position() { *

* 4.4.1.5 The end of central directory record and the Zip64 end of central directory locator record MUST reside on the same disk when splitting or spanning * an archive. + *

* * @param unsplittableContentSize * @throws IllegalArgumentException @@ -236,7 +240,7 @@ public void write(final byte[] b) throws IOException { } /** - * Write the data to ZIP split segments, if the remaining space of current split segment is not enough, then a new split segment should be created + * Writes the data to ZIP split segments, if the remaining space of current split segment is not enough, then a new split segment should be created * * @param b data to write * @param off offset of the start of data in param b @@ -309,7 +313,7 @@ private void writeToSegment( } /** - * Write the ZIP split signature (0x08074B50) to the head of the first ZIP split segment + * Writes the ZIP split signature (0x08074B50) to the head of the first ZIP split segment * * @throws IOException */