Sonar fix - "Add the missing @deprecated Javadoc tag."

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1876854 13f79535-47bb-0310-9956-ffa450edef68

src/java/org/apache/poi/ddf/AbstractEscherOptRecord.java

@@ -153,6 +153,9 @@ public abstract class AbstractEscherOptRecord extends EscherRecord {
         sortProperties();
     }
 
+    /**
+     * @deprecated use {@link #removeEscherProperty(EscherPropertyTypes)} instead
+     */
     @Deprecated
     @Removal(version = "5.0.0")
     public void removeEscherProperty(int num){

src/java/org/apache/poi/ddf/EscherComplexProperty.java

@@ -44,6 +44,8 @@ public class EscherComplexProperty extends EscherProperty {
      * @param id          The id consists of the property number, a flag indicating whether this is a blip id and a flag
      *                    indicating that this is a complex property.
      * @param complexData The value of this property.
+     *
+     * @deprecated use {@link #EscherComplexProperty(short, int)} and {@link #setComplexData(byte[])} instead
      */
     @Deprecated
     @Removal(version = "5.0.0")
@@ -59,6 +61,8 @@ public class EscherComplexProperty extends EscherProperty {
      * @param propertyNumber The property number
      * @param isBlipId       Whether this is a blip id.  Should be false.
      * @param complexData    The value of this complex property.
+     *
+     * @deprecated use {@link #EscherComplexProperty(EscherPropertyTypes, boolean, int)} and {@link #setComplexData(byte[])} instead
      */
     @Deprecated
     @Removal(version = "5.0.0")

src/java/org/apache/poi/hssf/record/AbstractEscherHolderRecord.java

@@ -126,8 +126,11 @@ public abstract class AbstractEscherHolderRecord extends Record {
     @Override
     public abstract short getSid();
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
-    @SuppressWarnings("squid:S2975")
+    @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated
     @Removal(version = "5.0.0")
     public AbstractEscherHolderRecord clone() {

src/java/org/apache/poi/hssf/record/ArrayRecord.java

@@ -89,6 +89,9 @@ public final class ArrayRecord extends SharedValueRecordBase {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/AutoFilterInfoRecord.java

@@ -84,6 +84,9 @@ public final class AutoFilterInfoRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/BOFRecord.java

@@ -262,6 +262,9 @@ public final class BOFRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/BlankRecord.java

@@ -132,6 +132,9 @@ public final class BlankRecord extends StandardRecord implements CellValueRecord
         return 6;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/BoolErrRecord.java

@@ -178,6 +178,9 @@ public final class BoolErrRecord extends CellRecord {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/BottomMarginRecord.java

@@ -74,6 +74,9 @@ public final class BottomMarginRecord extends StandardRecord implements Margin {
         this.field_1_margin = field_1_margin;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/CFHeader12Record.java

@@ -89,6 +89,9 @@ public final class CFHeader12Record extends CFHeaderBase implements FutureRecord
         return futureHeader.getAssociatedRange();
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CFHeaderBase.java

@@ -146,6 +146,9 @@ public abstract class CFHeaderBase extends StandardRecord {
         field_4_cell_ranges.serialize(out);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CFHeaderRecord.java

@@ -52,6 +52,9 @@ public final class CFHeaderRecord extends CFHeaderBase {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CFRule12Record.java

@@ -449,6 +449,9 @@ public final class CFRule12Record extends CFRuleBase implements FutureRecord {
         return len;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CFRuleBase.java

@@ -462,6 +462,9 @@ public abstract class CFRuleBase extends StandardRecord {
         return HSSFFormulaParser.parse(formula, sheet.getWorkbook(), FormulaType.CELL, sheetIndex);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CFRuleRecord.java

@@ -132,6 +132,9 @@ public final class CFRuleRecord extends CFRuleBase {
                getFormulaSize(getFormula2());
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/CalcCountRecord.java

@@ -86,6 +86,9 @@ public final class CalcCountRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/CalcModeRecord.java

@@ -101,6 +101,9 @@ public final class CalcModeRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/ColumnInfoRecord.java

@@ -239,6 +239,9 @@ public final class ColumnInfoRecord extends StandardRecord {
         return 12;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/CommonObjectDataSubRecord.java

@@ -136,6 +136,9 @@ public final class CommonObjectDataSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/ContinueRecord.java

@@ -66,6 +66,9 @@ public final class ContinueRecord extends StandardRecord {
         _data = in.readRemainder();
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DBCellRecord.java

@@ -67,6 +67,9 @@ public final class DBCellRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DVALRecord.java

@@ -155,6 +155,9 @@ public final class DVALRecord extends StandardRecord {
         return sid;
     }
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/DVRecord.java

@@ -331,6 +331,9 @@ public final class DVRecord extends StandardRecord {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/DefaultColWidthRecord.java

@@ -86,6 +86,9 @@ public final class DefaultColWidthRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DefaultRowHeightRecord.java

@@ -110,6 +110,9 @@ public final class DefaultRowHeightRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DeltaRecord.java

@@ -66,6 +66,9 @@ public final class DeltaRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DimensionsRecord.java

@@ -166,6 +166,9 @@ public final class DimensionsRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/DrawingSelectionRecord.java

@@ -114,6 +114,9 @@ public final class DrawingSelectionRecord extends StandardRecord {
 		}
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/EOFRecord.java

@@ -53,6 +53,9 @@ public final class EOFRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/EmbeddedObjectRefSubRecord.java

@@ -320,6 +320,9 @@ public final class EmbeddedObjectRefSubRecord extends SubRecord {
 		return field_6_unknown;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings("squid:S2975")
 	@Deprecated

src/java/org/apache/poi/hssf/record/EndSubRecord.java

@@ -70,6 +70,9 @@ public final class EndSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/FeatHdrRecord.java

@@ -112,6 +112,9 @@ public final class FeatHdrRecord extends StandardRecord {
 		return 12 + 2+1+4+rgbHdrData.length;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/FeatRecord.java

@@ -181,6 +181,9 @@ public final class FeatRecord extends StandardRecord {
 		}
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/FilePassRecord.java

@@ -138,6 +138,9 @@ public final class FilePassRecord extends StandardRecord {
 		return sid;
 	}
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/FileSharingRecord.java

@@ -133,6 +133,9 @@ public final class FileSharingRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/FooterRecord.java

@@ -41,6 +41,9 @@ public final class FooterRecord extends HeaderFooterBase {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/FormatRecord.java

@@ -107,6 +107,9 @@ public final class FormatRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/FormulaRecord.java

@@ -230,6 +230,9 @@ public final class FormulaRecord extends CellRecord {
 		return "FORMULA";
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/FtCblsSubRecord.java

@@ -87,6 +87,9 @@ public final class FtCblsSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/FtCfSubRecord.java

@@ -99,6 +99,9 @@ public final class FtCfSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/FtPioGrbitSubRecord.java

@@ -153,6 +153,9 @@ public final class FtPioGrbitSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/GridsetRecord.java

@@ -80,6 +80,9 @@ public final class GridsetRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/GroupMarkerSubRecord.java

@@ -75,6 +75,9 @@ public final class GroupMarkerSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/GutsRecord.java

@@ -164,6 +164,9 @@ public final class GutsRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/HCenterRecord.java

@@ -73,6 +73,9 @@ public final class HCenterRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/HeaderFooterRecord.java

@@ -88,6 +88,9 @@ public final class HeaderFooterRecord extends StandardRecord {
         return Arrays.equals(getGuid(), BLANK_GUID);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/HeaderRecord.java

@@ -41,6 +41,9 @@ public final class HeaderRecord extends HeaderFooterBase {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/HorizontalPageBreakRecord.java

@@ -48,6 +48,9 @@ public final class HorizontalPageBreakRecord extends PageBreakRecord {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/HyperlinkRecord.java

@@ -599,6 +599,9 @@ public final class HyperlinkRecord extends StandardRecord {
         setTextMark("");
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/IndexRecord.java

@@ -141,6 +141,9 @@ public final class IndexRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/IterationRecord.java

@@ -80,6 +80,9 @@ public final class IterationRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/LabelRecord.java

@@ -177,6 +177,9 @@ public final class LabelRecord extends Record implements CellValueRecordInterfac
     {
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/LabelSSTRecord.java

@@ -84,6 +84,9 @@ public final class LabelSSTRecord extends CellRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/LbsDataSubRecord.java

@@ -281,6 +281,9 @@ public class LbsDataSubRecord extends SubRecord {
         }
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/LeftMarginRecord.java

@@ -69,6 +69,9 @@ public final class LeftMarginRecord extends StandardRecord implements Margin {
         this.field_1_margin = field_1_margin;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/Margin.java

@@ -25,15 +25,15 @@ public interface Margin {
 	// TODO - introduce MarginBaseRecord
 	/**
 	 * Get the margin field for the Margin.
-	 * 
+	 *
 	 * @return the margin
 	 */
-	public double getMargin();
+	double getMargin();
 
 	/**
 	 * Set the margin field for the Margin.
-	 * 
+	 *
 	 * @param field_1_margin the margin
 	 */
-	public void setMargin(double field_1_margin);
+	void setMargin(double field_1_margin);
 }

src/java/org/apache/poi/hssf/record/MergeCellsRecord.java

@@ -103,6 +103,9 @@ public final class MergeCellsRecord extends StandardRecord {
 		}
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/MulBlankRecord.java

@@ -119,6 +119,9 @@ public final class MulBlankRecord extends StandardRecord {
 		return 6 + _xfs.length * 2;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/NoteRecord.java

@@ -241,6 +241,9 @@ public final class NoteRecord extends StandardRecord {
       field_5_hasMultibyte = StringUtil.hasMultibyte(author);
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/NoteStructureSubRecord.java

@@ -99,6 +99,9 @@ public final class NoteStructureSubRecord extends SubRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/NumberRecord.java

@@ -86,6 +86,9 @@ public final class NumberRecord extends CellRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/ObjRecord.java

@@ -215,6 +215,9 @@ public final class ObjRecord extends Record {
         return subrecords.add(o);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/ObjectProtectRecord.java

@@ -81,6 +81,9 @@ public final class ObjectProtectRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/PaneRecord.java

@@ -82,6 +82,9 @@ public final class PaneRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/PasswordRecord.java

@@ -77,6 +77,9 @@ public final class PasswordRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/PrintGridlinesRecord.java

@@ -75,6 +75,9 @@ public final class PrintGridlinesRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/PrintHeadersRecord.java

@@ -79,6 +79,9 @@ public final class PrintHeadersRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/PrintSetupRecord.java

@@ -316,6 +316,9 @@ public final class PrintSetupRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/ProtectRecord.java

@@ -84,6 +84,9 @@ public final class ProtectRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/RKRecord.java

@@ -94,6 +94,9 @@ public final class RKRecord extends CellRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/RefModeRecord.java

@@ -86,6 +86,9 @@ public final class RefModeRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/RefreshAllRecord.java

@@ -83,6 +83,9 @@ public final class RefreshAllRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/RightMarginRecord.java

@@ -63,6 +63,9 @@ public final class RightMarginRecord extends StandardRecord implements Margin {
     public void setMargin( double field_1_margin )
     {        this.field_1_margin = field_1_margin;    }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/RowRecord.java

@@ -403,6 +403,9 @@ public final class RowRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/SCLRecord.java

@@ -64,6 +64,9 @@ public final class SCLRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/SaveRecalcRecord.java

@@ -75,6 +75,9 @@ public final class SaveRecalcRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/ScenarioProtectRecord.java

@@ -86,6 +86,9 @@ public final class ScenarioProtectRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/SelectionRecord.java

@@ -173,6 +173,9 @@ public final class SelectionRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/SharedFormulaRecord.java

@@ -103,6 +103,9 @@ public final class SharedFormulaRecord extends SharedValueRecordBase {
         return sf.convertSharedFormulas(field_7_parsed_expr.getTokens(), formulaRow, formulaColumn);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/StringRecord.java

@@ -86,6 +86,9 @@ public final class StringRecord extends ContinuableRecord {
         _is16bitUnicode = StringUtil.hasMultibyte(string);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/SubRecord.java

@@ -167,6 +167,9 @@ public abstract class SubRecord implements Duplicatable, GenericRecord {
 			out.write(_data);
 		}
 
+		/**
+		 * @deprecated use {@link #copy()} instead
+		 */
 		@Override
 		@SuppressWarnings("squid:S2975")
 		@Deprecated

src/java/org/apache/poi/hssf/record/TextObjectRecord.java

@@ -317,6 +317,9 @@ public final class TextObjectRecord extends ContinuableRecord {
 		return _linkRefPtg;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/TopMarginRecord.java

@@ -67,6 +67,9 @@ public final class TopMarginRecord extends StandardRecord implements Margin {
     public void setMargin( double field_1_margin )
     {        this.field_1_margin = field_1_margin;    }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/UnknownRecord.java

@@ -265,6 +265,9 @@ public final class UnknownRecord extends StandardRecord {
         return false;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/UseSelFSRecord.java

@@ -68,6 +68,9 @@ public final class UseSelFSRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/UserSViewBegin.java

@@ -78,6 +78,9 @@ public final class UserSViewBegin extends StandardRecord {
         return Arrays.copyOf(_rawData, 16);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/UserSViewEnd.java

@@ -66,6 +66,9 @@ public final class UserSViewEnd extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/VCenterRecord.java

@@ -78,6 +78,9 @@ public final class VCenterRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/VerticalPageBreakRecord.java

@@ -48,6 +48,9 @@ public final class VerticalPageBreakRecord extends PageBreakRecord {
 		return sid;
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
 	@Deprecated

src/java/org/apache/poi/hssf/record/WSBoolRecord.java

@@ -296,6 +296,9 @@ public final class WSBoolRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/WindowProtectRecord.java

@@ -84,6 +84,9 @@ public final class WindowProtectRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/WindowTwoRecord.java

@@ -461,6 +461,9 @@ public final class WindowTwoRecord extends StandardRecord {
         return sid;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/aggregates/ColumnInfoRecordsAggregate.java

@@ -61,6 +61,9 @@ public final class ColumnInfoRecordsAggregate extends RecordAggregate implements
 		}
 	}
 
+	/**
+	 * @deprecated use {@link #copy()} instead
+	 */
 	@Override
 	@SuppressWarnings("squid:S2975")
 	@Deprecated

src/java/org/apache/poi/hssf/record/aggregates/ValueRecordsAggregate.java

@@ -29,6 +29,7 @@ import org.apache.poi.hssf.record.Record;
 import org.apache.poi.hssf.record.RecordBase;
 import org.apache.poi.hssf.record.StringRecord;
 import org.apache.poi.hssf.record.aggregates.RecordAggregate.RecordVisitor;
+import org.apache.poi.hssf.usermodel.HSSFWorkbook;
 import org.apache.poi.ss.formula.FormulaShifter;
 import org.apache.poi.ss.formula.ptg.Ptg;
 import org.apache.poi.util.Removal;
@@ -360,6 +361,9 @@ public final class ValueRecordsAggregate implements Iterable<CellValueRecordInte
 		return new ValueIterator();
 	}
 
+	/**
+	 * @deprecated use {@link org.apache.poi.hssf.usermodel.HSSFSheet#cloneSheet(HSSFWorkbook)} instead
+	 */
 	@Override
 	@SuppressWarnings("squid:S2975")
 	@Deprecated

src/java/org/apache/poi/hssf/record/cf/BorderFormatting.java

@@ -463,6 +463,9 @@ public final class BorderFormatting implements Duplicatable, GenericRecord {
         return GenericRecordJsonWriter.marshal(this);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/cf/ColorGradientFormatting.java

@@ -151,6 +151,9 @@ public final class ColorGradientFormatting implements Duplicatable, GenericRecor
         return GenericRecordJsonWriter.marshal(this);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/cf/ColorGradientThreshold.java

@@ -60,6 +60,9 @@ public final class ColorGradientThreshold extends Threshold implements Duplicata
         return super.getDataLength() + 8;
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/cf/DataBarFormatting.java

@@ -154,6 +154,9 @@ public final class DataBarFormatting implements Duplicatable, GenericRecord {
         return GenericRecordJsonWriter.marshal(this);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated

src/java/org/apache/poi/hssf/record/cf/DataBarThreshold.java

@@ -39,6 +39,9 @@ public final class DataBarThreshold extends Threshold implements Duplicatable {
         super(in);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings("squid:S2975")
     @Deprecated

src/java/org/apache/poi/hssf/record/cf/FontFormatting.java

@@ -488,6 +488,9 @@ public final class FontFormatting implements Duplicatable, GenericRecord {
         return GenericRecordJsonWriter.marshal(this);
     }
 
+    /**
+     * @deprecated use {@link #copy()} instead
+     */
     @Override
     @SuppressWarnings({"squid:S2975", "MethodDoesntCallSuperMethod"})
     @Deprecated