]> source.dussan.org Git - poi.git/commitdiff
javadoc issues
authorPJ Fanning <fanningpj@apache.org>
Sun, 10 Jul 2022 10:29:33 +0000 (10:29 +0000)
committerPJ Fanning <fanningpj@apache.org>
Sun, 10 Jul 2022 10:29:33 +0000 (10:29 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1902624 13f79535-47bb-0310-9956-ffa450edef68

27 files changed:
poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/RepeatingRowsAndColumns.java
poi-examples/src/main/java/org/apache/poi/examples/ss/AddDimensionedImage.java
poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithPageSetup.java
poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/OPCPackage.java
poi-ooxml/src/main/java/org/apache/poi/xssf/model/Styles.java
poi-ooxml/src/main/java/org/apache/poi/xssf/model/StylesTable.java
poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCellStyle.java
poi-ooxml/src/test/java/org/apache/poi/ss/tests/formula/TestFormulaParser.java
poi/src/main/java/org/apache/poi/ddf/EscherSpRecord.java
poi/src/main/java/org/apache/poi/ddf/UnknownEscherRecord.java
poi/src/main/java/org/apache/poi/hpsf/Section.java
poi/src/main/java/org/apache/poi/hssf/record/DVALRecord.java
poi/src/main/java/org/apache/poi/hssf/record/NoteStructureSubRecord.java
poi/src/main/java/org/apache/poi/hssf/record/aggregates/FormulaRecordAggregate.java
poi/src/main/java/org/apache/poi/hssf/record/aggregates/SharedValueManager.java
poi/src/main/java/org/apache/poi/poifs/crypt/CryptoFunctions.java
poi/src/main/java/org/apache/poi/poifs/filesystem/BATManaged.java
poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java
poi/src/main/java/org/apache/poi/poifs/macros/VBAMacroReader.java
poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java
poi/src/main/java/org/apache/poi/sl/usermodel/PresetColor.java
poi/src/main/java/org/apache/poi/ss/util/ImageUtils.java
poi/src/main/java/org/apache/poi/ss/util/MutableFPNumber.java
poi/src/test/java/org/apache/poi/hssf/model/TestFormulaParser.java
poi/src/test/java/org/apache/poi/hssf/usermodel/TestHSSFDataFormatter.java
poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestNamedRange.java

index db737cd5bbab7f76ba08f2cb537e432f20c468a3..a48c8ed14b403462e401c0e198570aa149b678aa 100644 (file)
@@ -51,7 +51,7 @@ public class RepeatingRowsAndColumns {
             sheet1.setRepeatingColumns(CellRangeAddress.valueOf("A:C"));
             // Set the rows to repeat from row 0 to 2 on the second sheet.
             sheet2.setRepeatingRows(CellRangeAddress.valueOf("1:3"));
-            // Set the the repeating rows and columns on the third sheet.
+            // Set the repeating rows and columns on the third sheet.
             CellRangeAddress cra = CellRangeAddress.valueOf("D1:E2");
             sheet3.setRepeatingColumns(cra);
             sheet3.setRepeatingRows(cra);
index 6a764d6e32e17abaf07cf925ea57ae82ea58d934..c41e4c0007ccd856231e375cf5aeb0fdd85055e7 100644 (file)
@@ -116,7 +116,7 @@ import java.util.Locale;
  * <p>
  * The following example demonstrates a slightly different way to insert an
  * image into cell A1 and to ensure that it occupies the whole of the cell. This
- * is accomplished by specifying the the images bottom right hand corner should be
+ * is accomplished by specifying the images bottom right hand corner should be
  * aligned with the bottom right hand corner of the cell. It is also a case
  * where the image will not increase in size if the user increases the size of
  * the enclosing cell - irrespective of the anchors type - but it will reduce in
@@ -182,7 +182,7 @@ import java.util.Locale;
  *
  * @version 1.00 5th August 2009.
  * 2.00 26th February 2010.
- * Ported to make use of the the SS usermodel classes.
+ * Ported to make use of the SS usermodel classes.
  * Ability to reuse the Drawing Patriarch so that multiple images
  * can be inserted without unintentionally erasing earlier images.
  * Check on image type added; i.e. jpg, jpeg or png.
index f05f6ff8d1534e3599636af90ed3877c31a598b4..2fe5e9c826eecdf84d0dfa3d82cb42eb73ea2983 100644 (file)
@@ -65,7 +65,7 @@ public class WorkingWithPageSetup {
 
             // Set the columns to repeat from column 0 to 2 on the first sheet
             sheet1.setRepeatingColumns(CellRangeAddress.valueOf("A:C"));
-            // Set the the repeating rows and columns on the second sheet.
+            // Set the repeating rows and columns on the second sheet.
             CellRangeAddress cra = CellRangeAddress.valueOf("E2:F3");
             sheet2.setRepeatingColumns(cra);
             sheet2.setRepeatingRows(cra);
index 1035459f821a7add0b034c472bd1f8d0d0316d5b..843e4d7e9bdd1bbed96da2d80d3aad1690be2693 100644 (file)
@@ -1469,7 +1469,7 @@ public abstract class OPCPackage implements RelationshipSource, Closeable {
 
         this.throwExceptionIfReadOnly();
 
-        // You shouldn't save the the same file, do a close instead
+        // You shouldn't save the same file, do a close instead
         if(targetFile.exists() &&
                 targetFile.getAbsolutePath().equals(this.originalPackagePath)) {
             throw new InvalidOperationException(
index 135581c7d0dad3b63a97c828426387692bf91936..7f2460f323b26c9bf44f0bde37476d69b5450a30 100644 (file)
@@ -34,7 +34,7 @@ public interface Styles {
 
     /**
      * Puts <code>fmt</code> in the numberFormats map if the format is not
-     * already in the the number format style table.
+     * already in the number format style table.
      * Does nothing if <code>fmt</code> is already in number format style table.
      *
      * @param fmt the number format to add to number format style table
index 3345eac4ebb41a70382b8843f22d28f87920ee79..c56cece348018e0e21d11a1653f2225ae8481310 100644 (file)
@@ -308,7 +308,7 @@ public class StylesTable extends POIXMLDocumentPart implements Styles {
 
     /**
      * Puts {@code fmt} in the numberFormats map if the format is not
-     * already in the the number format style table.
+     * already in the number format style table.
      * Does nothing if {@code fmt} is already in number format style table.
      *
      * @param fmt the number format to add to number format style table
index 37ea1519be31d10115674d2e935350cf0e11824e..c6982ca3ce94d4faefffcc5d5aa5fff8ebc6cf97 100644 (file)
@@ -338,7 +338,7 @@ public class SXSSFWorkbook implements Workbook {
      *   If the "compress" flag is set to <code>true</code> then the temporary XML is gzipped.
      * </p>
      * <p>
-     *     Please note the the "compress" option may cause performance penalty.
+     *     Please note the "compress" option may cause performance penalty.
      * </p>
      * <p>
      *     Setting this option only affects compression for subsequent <code>createSheet()</code>
index 8d37d107097b0790c97a36b5e301d7cc1789ad32..ec50f0d5d7a771f3713d71b6f222a75efa1821c8 100644 (file)
@@ -51,7 +51,7 @@ import org.openxmlformats.schemas.spreadsheetml.x2006.main.STPatternType;
 
 /**
  *
- * High level representation of the the possible formatting information for the contents of the cells on a sheet in a
+ * High level representation of the possible formatting information for the contents of the cells on a sheet in a
  * SpreadsheetML document.
  *
  * @see org.apache.poi.xssf.usermodel.XSSFWorkbook#createCellStyle()
index 18e189b03c9906a39eb1d0964c05cf31c52a287c..213686f62f18c70c72089f53ae30369c473c1e7b 100644 (file)
@@ -108,7 +108,7 @@ class TestFormulaParser {
             assertEquals("arg", arg.getValue());
 
             // The external FunctionPtg is the last Ptg added to the stack
-            // During formula evaluation, this Ptg pops off the the appropriate number of
+            // During formula evaluation, this Ptg pops off the appropriate number of
             // arguments (getNumberOfOperands()) and pushes the result on the stack
             AbstractFunctionPtg tfunc = (AbstractFunctionPtg) ptg[2];
             assertTrue(tfunc.isExternalFunction());
index acec08ed32c48fa709018f1c0407bbc53d3e9b8b..208e22bcbce3dd41e60b71005bbcba0fd3637e1e 100644 (file)
@@ -26,7 +26,7 @@ import org.apache.poi.util.GenericRecordUtil;
 import org.apache.poi.util.LittleEndian;
 
 /**
- * Together the the EscherOptRecord this record defines some of the basic
+ * Together the EscherOptRecord this record defines some of the basic
  * properties of a shape.
  */
 public class EscherSpRecord extends EscherRecord {
index 28fbfb28c4784e33baac0ae93bbbc0e4eda076f9..aff4e213f97b5cd08cca4e988fb97a15ea0b17a3 100644 (file)
@@ -39,7 +39,7 @@ public final class UnknownEscherRecord extends EscherRecord {
 
     private static final byte[] NO_BYTES = new byte[0];
 
-    /** The data for this record not including the the 8 byte header */
+    /** The data for this record not including the 8 byte header */
     private byte[] thedata = NO_BYTES;
     private final List<EscherRecord> _childRecords = new ArrayList<>();
 
index e7c5245da9f0c884b4b09753eeaad460ab41d555..5ebaf43ad336a3543c9f36859cb12da02bc0dbd6 100644 (file)
@@ -634,7 +634,7 @@ public class Section {
 
     /**
      * Checks whether this section is equal to another object. The result is
-     * {@code false} if one of the the following conditions holds:
+     * {@code false} if one of the following conditions holds:
      *
      * <ul>
      *
index 9589315aa37f8251e3331d25f3095ab65a07d32f..9c37e5c4df06d2fb998bfe92a8a4abb628c67419 100644 (file)
@@ -118,7 +118,7 @@ public final class DVALRecord extends StandardRecord {
     }
 
     /**
-     * @return the the Vertical position of the dialog
+     * @return the Vertical position of the dialog
      */
     public int getVerticalPos() {
         return field_3_vert_pos;
index 67256f11acb9d2901ed4aed0b76185c411fe273d..e15e05a92f614db2ed48814f6b7e8dfc761e55c4 100644 (file)
@@ -43,7 +43,7 @@ public final class NoteStructureSubRecord extends SubRecord {
      * fill its data with the default values
      */
     public NoteStructureSubRecord() {
-        //all we know is that the the length of <code>NoteStructureSubRecord</code> is always 22 bytes
+        //all we know is that the length of <code>NoteStructureSubRecord</code> is always 22 bytes
         reserved = new byte[ENCODED_SIZE];
     }
 
index 76d88a28d2cf277c2e42d1abf237991ec9bb32c0..5ce1f62f686e68c1a464559579f700250702065d 100644 (file)
@@ -82,7 +82,7 @@ public final class FormulaRecordAggregate extends RecordAggregate implements Cel
      * {@link SharedFormulaRecord} does not exist). Normally this would leave no way of determining
      * the {@link Ptg} tokens for the formula.  However as it turns out in these
      * cases, Excel encodes the unshared {@link Ptg} tokens in the right place (inside the {@link
-     * FormulaRecord}).  So the the only thing that needs to be done is to ignore the erroneous
+     * FormulaRecord}).  So the only thing that needs to be done is to ignore the erroneous
      * shared formula flag.<br>
      *
      * This method may also be used for setting breakpoints to help diagnose issues regarding the
index 20d73d80a3f8ea2b4d5a7f809fe1114552debad2..45e3c12c44c810ff427de03229f71685a797ccce 100644 (file)
@@ -184,7 +184,7 @@ public final class SharedValueManager {
      *
      * @return the SHRFMLA, TABLE or ARRAY record for the formula cell, if it is the first cell of
      * a table or array region. {@code null} if the formula cell is not shared/array/table,
-     * or if the specified formula is not the the first in the group.
+     * or if the specified formula is not the first in the group.
      */
     public SharedValueRecordBase getRecordForFirstCell(FormulaRecordAggregate agg) {
         CellReference firstCell = agg.getFormulaRecord().getFormula().getExpReference();
index ea0298a8291cfd45d98db5cf4245bc21ddc23d23..d48c58f1f16ae7dc84252d2f600c9e372138f7fe 100644 (file)
@@ -161,7 +161,7 @@ public final class CryptoFunctions {
      *     {@code blockKey: IV = H(KeySalt + blockKey)}</li>
      * <li>If a blockKey is not provided, let IV be equal to the following value:<br>
      *     {@code KeySalt:IV = KeySalt}</li>
-     * <li>If the number of bytes in the value of IV is less than the the value of the blockSize attribute
+     * <li>If the number of bytes in the value of IV is less than the value of the blockSize attribute
      *     corresponding to the cipherAlgorithm attribute, pad the array of bytes by appending 0x36 until
      *     the array is blockSize bytes. If the array of bytes is larger than blockSize bytes, truncate the
      *     array to blockSize bytes.</li>
index dd0a6d679a1baacbffff0d2c0b86a64e991f0a02..3f6631e1ea028b1a15b7760756923761fe442324 100644 (file)
@@ -39,7 +39,7 @@ public interface BATManaged
      * Set the start block for this instance
      *
      * @param index index into the array of BigBlock instances making
-     *              up the the filesystem
+     *              up the filesystem
      */
 
     void setStartBlock(final int index);
index 2179ecdfdcad7984d41248fe4d79b1f7812db69c..61797ad2f8c74cd76f9628b23840e960000c1c22 100644 (file)
@@ -52,7 +52,7 @@ public class POIFSDocumentPath {
      * constructor for the path of a document that is not in the root of the POIFSFileSystem
      *
      * @param components the Strings making up the path to a document.
-     *      The Strings must be ordered as they appear in the directory hierarchy of the the document.
+     *      The Strings must be ordered as they appear in the directory hierarchy of the document.
      *      The first string must be the name of a directory in the root of the POIFSFileSystem, and
      *      every Nth (for N &gt; 1) string thereafter must be the name of a directory in the directory
      *      identified by the (N-1)th string.<p>
index 789bfbb702150748cd279904704707defa928c7b..23b2936af3816e54bbdf007b6266a05103adb5d5 100644 (file)
@@ -785,7 +785,7 @@ public class VBAMacroReader implements Closeable {
 
     /**
      * Sometimes the offset record in the dirstream is incorrect, but the macro can still be found.
-     * This will try to find the the first RLEDecompressing stream that starts with "Attribute".
+     * This will try to find the first RLEDecompressing stream that starts with "Attribute".
      * This relies on some, er, heuristics, admittedly.
      *
      * @param is full module inputstream to read
index c595c71a997d09a1af82a5ad77d1513a5201fc18..bd597607e46590f2efb0273285155ce38c6d5153 100644 (file)
@@ -152,7 +152,7 @@ public final class PropertyTable implements BATManaged {
      * Set the start block for this instance
      *
      * @param index index into the array of BigBlock instances making
-     *              up the the filesystem
+     *              up the filesystem
      */
     public void setStartBlock(final int index) {
         _header_block.setPropertyStart(index);
index 2538d1b828600b406f5374af066cf32d719d98be..6ba3a4c514557fa53447f129f5448864435a091e 100644 (file)
@@ -31,7 +31,7 @@ import java.util.Map;
  */
 public enum PresetColor {
     // the order of this enum can be found in the definition of .net System.Drawing.KnownColor enumeration
-    // or by running the the program in the linked documentation
+    // or by running the program in the linked documentation
     
     // default colors for theme-depending colors taken from ... (last post):
     // https://social.technet.microsoft.com/Forums/windows/en-US/ac76cc56-6ff2-4778-b260-8141d7170a3b/windows-7-highlight-text-color-or-selected-text-color-in-aero
index b156ba060761c1400ec7f036e75fa18e0e9612f8..adb426d35821ca3273d7d15c9e303bd86f1eef78 100644 (file)
@@ -111,7 +111,7 @@ public final class ImageUtils {
 
     /**
      * The metadata of PNG and JPEG can contain the width of a pixel in millimeters.
-     * Return the the "effective" dpi calculated as <code>25.4/HorizontalPixelSize</code>
+     * Return the "effective" dpi calculated as <code>25.4/HorizontalPixelSize</code>
      * and <code>25.4/VerticalPixelSize</code>.  Where 25.4 is the number of mm in inch.
      *
      * @return array of two elements: <code>{horizontalDpi, verticalDpi}</code>.
index 0eb27696d08069af222e701614d85535d18cc070..335446e7ae4aecf1188755450c91b07168c1c99d 100644 (file)
@@ -25,7 +25,7 @@ final class MutableFPNumber {
     // TODO - what about values between (10<sup>14</sup>-0.5) and (10<sup>14</sup>-0.05) ?
     /**
      * The minimum value in 'Base-10 normalised form'.<br>
-     * When {@link #_binaryExponent} == 46 this is the the minimum {@link #_frac} value
+     * When {@link #_binaryExponent} == 46 this is the minimum {@link #_frac} value
      *  (10<sup>14</sup>-0.05) * 2^17
      *  <br>
      *  Values between (10<sup>14</sup>-0.05) and 10<sup>14</sup> will be represented as '1'
index f10d035d6c3fa743c57f2d105fe5e647997ad943..ca3d312f83a031e060dc17c9b6f8bb225207cd0c 100644 (file)
@@ -139,7 +139,7 @@ final class TestFormulaParser {
             assertEquals("arg", arg.getValue());
 
             // The external FunctionPtg is the last Ptg added to the stack
-            // During formula evaluation, this Ptg pops off the the appropriate number of
+            // During formula evaluation, this Ptg pops off the appropriate number of
             // arguments (getNumberOfOperands()) and pushes the result on the stack
             AbstractFunctionPtg tfunc = (AbstractFunctionPtg) ptg[2]; //FuncVarPtg
             assertTrue(tfunc.isExternalFunction());
index 9e9846e1efd4ff7c248792350802db762ff89644..576fa6e279810a65dfa75ce7b51a9fd8e5a0dcc6 100644 (file)
@@ -298,7 +298,7 @@ public final class TestHSSFDataFormatter {
         while (it.hasNext()) {
             HSSFCell cell = (HSSFCell) it.next();
             log(formatter.formatCellValue(cell));
-            // in some locales the the decimal delimiter is a comma, not a dot
+            // in some locales the decimal delimiter is a comma, not a dot
             char decimalSeparator = DecimalFormatSymbols.getInstance(LocaleUtil.getUserLocale()).getDecimalSeparator();
             assertEquals("12345678" + decimalSeparator + "9", formatter.formatCellValue(cell));
         }
index 60a676fc7b0967886ff6d23c5cee37025caab0e8..cdc514f3abfb428af42f2f5949f6b856b404249a 100644 (file)
@@ -524,7 +524,7 @@ public abstract class BaseTestNamedRange {
      * </pre>
      *
      * This caused trouble for anything that requires {@link Name#getRefersToFormula()}
-     * It is easy enough to re-create the the same data (by not setting the formula). Excel
+     * It is easy enough to re-create the same data (by not setting the formula). Excel
      * seems to gracefully remove this uninitialized name record.  It would be nice if POI
      * could do the same, but that would involve adjusting subsequent name indexes across
      * all formulas. <p>