This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-compress.git
The following commit(s) were added to refs/heads/master by this push:
new 7360f37c2 Javadoc: The @deprecated tag should be last.
7360f37c2 is described below
commit 7360f37c2d48ead7558f60e1aa054808009c792d
Author: Gary Gregory <[email protected]>
AuthorDate: Wed Dec 31 18:34:49 2025 -0500
Javadoc: The @deprecated tag should be last.
---
.../apache/commons/compress/archivers/cpio/CpioArchiveEntry.java | 4 ++--
.../org/apache/commons/compress/archivers/jar/JarArchiveEntry.java | 2 +-
.../commons/compress/archivers/sevenz/SevenZArchiveEntry.java | 6 +++---
.../commons/compress/compressors/CompressorStreamFactory.java | 2 +-
.../commons/compress/compressors/xz/XZCompressorInputStream.java | 2 +-
5 files changed, 8 insertions(+), 8 deletions(-)
diff --git
a/src/main/java/org/apache/commons/compress/archivers/cpio/CpioArchiveEntry.java
b/src/main/java/org/apache/commons/compress/archivers/cpio/CpioArchiveEntry.java
index dc3c02c98..4df118774 100644
---
a/src/main/java/org/apache/commons/compress/archivers/cpio/CpioArchiveEntry.java
+++
b/src/main/java/org/apache/commons/compress/archivers/cpio/CpioArchiveEntry.java
@@ -521,10 +521,10 @@ public long getGID() {
/**
* Gets the number of bytes needed to pad the header to the alignment
boundary.
*
- * @deprecated This method doesn't properly work for multi-byte encodings.
And creates corrupt archives. Use {@link #getHeaderPadCount(Charset)} or
- * {@link #getHeaderPadCount(long)} in any case.
* @return the number of bytes needed to pad the header (0,1,2,3).
* @throws ArchiveException if a computation overflows an {@code int}.
+ * @deprecated This method doesn't properly work for multi-byte encodings.
And creates corrupt archives. Use {@link #getHeaderPadCount(Charset)} or
+ * {@link #getHeaderPadCount(long)} in any case.
*/
@Deprecated
public int getHeaderPadCount() throws ArchiveException {
diff --git
a/src/main/java/org/apache/commons/compress/archivers/jar/JarArchiveEntry.java
b/src/main/java/org/apache/commons/compress/archivers/jar/JarArchiveEntry.java
index 3995d97a1..4880123f4 100644
---
a/src/main/java/org/apache/commons/compress/archivers/jar/JarArchiveEntry.java
+++
b/src/main/java/org/apache/commons/compress/archivers/jar/JarArchiveEntry.java
@@ -92,8 +92,8 @@ public Certificate[] getCertificates() {
/**
* This method is not implemented and won't ever be. The JVM equivalent
has a different name {@link java.util.jar.JarEntry#getAttributes()}
*
- * @deprecated Since 1.5, do not use; always returns null
* @return Always returns null.
+ * @deprecated Since 1.5, do not use; always returns null
*/
@Deprecated
public Attributes getManifestAttributes() {
diff --git
a/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZArchiveEntry.java
b/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZArchiveEntry.java
index 2318577a3..df67e8c66 100644
---
a/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZArchiveEntry.java
+++
b/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZArchiveEntry.java
@@ -44,8 +44,8 @@ public class SevenZArchiveEntry implements ArchiveEntry {
*
* @param date the Java time.
* @return the NTFS time.
- * @deprecated Use {@link FileTimes#toNtfsTime(Date)} instead.
* @see FileTimes#toNtfsTime(Date)
+ * @deprecated Use {@link FileTimes#toNtfsTime(Date)} instead.
*/
@Deprecated
public static long javaTimeToNtfsTime(final Date date) {
@@ -57,8 +57,8 @@ public static long javaTimeToNtfsTime(final Date date) {
*
* @param ntfsTime the NTFS time in 100 nanosecond units.
* @return the Java time.
- * @deprecated Use {@link FileTimes#ntfsTimeToDate(long)} instead.
* @see FileTimes#ntfsTimeToDate(long)
+ * @deprecated Use {@link FileTimes#ntfsTimeToDate(long)} instead.
*/
@Deprecated
public static Date ntfsTimeToJavaTime(final long ntfsTime) {
@@ -445,8 +445,8 @@ public void setAntiItem(final boolean isAntiItem) {
/**
* Sets the compressed CRC.
*
- * @deprecated use setCompressedCrcValue instead.
* @param crc the CRC.
+ * @deprecated use setCompressedCrcValue instead.
*/
@Deprecated
void setCompressedCrc(final int crc) {
diff --git
a/src/main/java/org/apache/commons/compress/compressors/CompressorStreamFactory.java
b/src/main/java/org/apache/commons/compress/compressors/CompressorStreamFactory.java
index a92ed5b65..5e26a7ac3 100644
---
a/src/main/java/org/apache/commons/compress/compressors/CompressorStreamFactory.java
+++
b/src/main/java/org/apache/commons/compress/compressors/CompressorStreamFactory.java
@@ -783,8 +783,8 @@ public Set<String> getOutputStreamCompressorNames() {
* @param decompressConcatenated if true, decompress until the end of the
input; if false, stop after the first stream and leave the input position to
point
* to the next byte after the stream.
* @since 1.5
- * @deprecated 1.10 use the {@link #CompressorStreamFactory(boolean)}
constructor instead.
* @throws IllegalStateException if the constructor {@link
#CompressorStreamFactory(boolean)} was used to create the factory.
+ * @deprecated 1.10 use the {@link #CompressorStreamFactory(boolean)}
constructor instead.
*/
@Deprecated
public void setDecompressConcatenated(final boolean
decompressConcatenated) {
diff --git
a/src/main/java/org/apache/commons/compress/compressors/xz/XZCompressorInputStream.java
b/src/main/java/org/apache/commons/compress/compressors/xz/XZCompressorInputStream.java
index f5a92e518..1651b1040 100644
---
a/src/main/java/org/apache/commons/compress/compressors/xz/XZCompressorInputStream.java
+++
b/src/main/java/org/apache/commons/compress/compressors/xz/XZCompressorInputStream.java
@@ -204,8 +204,8 @@ public XZCompressorInputStream(final InputStream
inputStream, final boolean deco
* @throws IOException if the input is not in the .xz format, the input is
corrupt or truncated, the .xz headers specify options that are not supported by
* this implementation, or the underlying {@code
inputStream} throws an exception
*
- * @deprecated Use {@link #builder()}.
* @since 1.14
+ * @deprecated Use {@link #builder()}.
*/
@Deprecated
public XZCompressorInputStream(final InputStream inputStream, final
boolean decompressConcatenated, final int memoryLimitKiB) throws IOException {
