use 'an'

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

22 files changed, 30 insertions, 30 deletions

diff --git a/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java b/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java
index b47b02e53b..984e86eb86 100644
--- a/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java
+++ b/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java
@@ -29,7 +29,7 @@ import org.apache.poi.util.Beta;
  * If an implementation doesn't provide a property, the getter will return {@code null} -
  * if the value is unset, a default value will be returned.<p>
  *
- * Setting a unsupported property results in an {@link UnsupportedOperationException}.
+ * Setting an unsupported property results in an {@link UnsupportedOperationException}.
  *
  * @since POI 3.17-beta2
  *
diff --git a/poi/src/main/java/org/apache/poi/ddf/UnknownEscherRecord.java b/poi/src/main/java/org/apache/poi/ddf/UnknownEscherRecord.java
index aff4e213f9..c6e71ea099 100644
--- a/poi/src/main/java/org/apache/poi/ddf/UnknownEscherRecord.java
+++ b/poi/src/main/java/org/apache/poi/ddf/UnknownEscherRecord.java
@@ -28,7 +28,7 @@ import org.apache.poi.util.IOUtils;
 import org.apache.poi.util.LittleEndian;
 
 /**
- * This record is used whenever a escher record is encountered that
+ * This record is used whenever an escher record is encountered that
  * we do not explicitly support.
  */
 public final class UnknownEscherRecord extends EscherRecord {
diff --git a/poi/src/main/java/org/apache/poi/hpsf/Section.java b/poi/src/main/java/org/apache/poi/hpsf/Section.java
index 5ebaf43ad3..09ce055d34 100644
--- a/poi/src/main/java/org/apache/poi/hpsf/Section.java
+++ b/poi/src/main/java/org/apache/poi/hpsf/Section.java
@@ -131,7 +131,7 @@ public class Section {
          */
         int offFix = (int)LittleEndian.getUInt(src, offset + ClassID.LENGTH);
 
-        // some input files have a invalid (padded?) offset, which need to be fixed
+        // some input files have an invalid (padded?) offset, which need to be fixed
         // search for beginning of size field
         if (src[offFix] == 0) {
             for (int i=0; i<3 && src[offFix] == 0; i++,offFix++);
diff --git a/poi/src/main/java/org/apache/poi/hssf/record/ExternalNameRecord.java b/poi/src/main/java/org/apache/poi/hssf/record/ExternalNameRecord.java
index 195b0593f6..3b58817cec 100644
--- a/poi/src/main/java/org/apache/poi/hssf/record/ExternalNameRecord.java
+++ b/poi/src/main/java/org/apache/poi/hssf/record/ExternalNameRecord.java
@@ -127,7 +127,7 @@ public final class ExternalNameRecord extends StandardRecord {
     /**
      * For OLE and DDE, links can be either 'automatic' or 'manual'
      *
-     * @return {@code true} if this is a automatic link
+     * @return {@code true} if this is an automatic link
      */
     public boolean isAutomaticLink() {
         return (field_1_option_flag & OPT_AUTOMATIC_LINK) != 0;
diff --git a/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java b/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java
index a64d86b9d0..b41c2b9146 100644
--- a/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java
+++ b/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java
@@ -447,7 +447,7 @@ public final class RecordInputStream implements LittleEndianInput {
      *
      * @return all byte data for the current record
      *
-     * @deprecated POI 2.0 Best to write a input stream that wraps this one
+     * @deprecated POI 2.0 Best to write an input stream that wraps this one
      *             where there is special sub record that may overlap continue
      *             records.
      */
diff --git a/poi/src/main/java/org/apache/poi/hssf/record/chart/AreaRecord.java b/poi/src/main/java/org/apache/poi/hssf/record/chart/AreaRecord.java
index 93462b4878..6babe30755 100644
--- a/poi/src/main/java/org/apache/poi/hssf/record/chart/AreaRecord.java
+++ b/poi/src/main/java/org/apache/poi/hssf/record/chart/AreaRecord.java
@@ -29,7 +29,7 @@ import org.apache.poi.util.GenericRecordUtil;
 import org.apache.poi.util.LittleEndianOutput;
 
 /**
- * The area record is used to define a area chart.
+ * The area record is used to define an area chart.
  */
 public final class AreaRecord extends StandardRecord {
     public static final short sid = 0x101A;
diff --git a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFCell.java b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFCell.java
index 7e5f7f5fb7..76eadaabe4 100644
--- a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFCell.java
+++ b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFCell.java
@@ -786,7 +786,7 @@ public class HSSFCell extends CellBase {
     }
 
     /**
-     * set a error value for the cell
+     * set an error value for the cell
      *
      * @param errorCode the error value to set this cell to.  For formulas, we'll set the
      *        precalculated value , for errors we'll set
@@ -802,7 +802,7 @@ public class HSSFCell extends CellBase {
         setCellErrorValue(error);
     }
     /**
-     * set a error value for the cell
+     * set an error value for the cell
      *
      * @param error the error value to set this cell to.  For formulas, we'll set the
      *        precalculated value , for errors we'll set
diff --git a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPatriarch.java b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPatriarch.java
index 876b6f245a..716e215bbc 100644
--- a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPatriarch.java
+++ b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPatriarch.java
@@ -370,7 +370,7 @@ public final class HSSFPatriarch implements HSSFShapeContainer, Drawing<HSSFShap
     }
 
     /**
-     * Returns a unmodifiable list of all shapes contained by the patriarch.
+     * Returns an unmodifiable list of all shapes contained by the patriarch.
      */
     @Override
     public List<HSSFShape> getChildren() {
diff --git a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPicture.java b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPicture.java
index 29b163ce67..42fa643a36 100644
--- a/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPicture.java
+++ b/poi/src/main/java/org/apache/poi/hssf/usermodel/HSSFPicture.java
@@ -40,7 +40,7 @@ import org.apache.poi.ss.util.ImageUtils;
 import org.apache.poi.util.StringUtil;
 
 /**
- * Represents a escher picture.  Eg. A GIF, JPEG etc...
+ * Represents an escher picture.  Eg. A GIF, JPEG etc...
  */
 public class HSSFPicture extends HSSFSimpleShape implements Picture {
 
diff --git a/poi/src/main/java/org/apache/poi/poifs/crypt/Encryptor.java b/poi/src/main/java/org/apache/poi/poifs/crypt/Encryptor.java
index 0e2581a64e..746d8fa5fd 100644
--- a/poi/src/main/java/org/apache/poi/poifs/crypt/Encryptor.java
+++ b/poi/src/main/java/org/apache/poi/poifs/crypt/Encryptor.java
@@ -45,7 +45,7 @@ public abstract class Encryptor implements GenericRecord {
     }
 
     /**
-     * Return a output stream for encrypted data.
+     * Return an output stream for encrypted data.
      *
      * @param dir the node to write to
      * @return encrypted stream
diff --git a/poi/src/main/java/org/apache/poi/sl/draw/SLGraphics.java b/poi/src/main/java/org/apache/poi/sl/draw/SLGraphics.java
index fe7afec9eb..a570b9f892 100644
--- a/poi/src/main/java/org/apache/poi/sl/draw/SLGraphics.java
+++ b/poi/src/main/java/org/apache/poi/sl/draw/SLGraphics.java
@@ -925,9 +925,9 @@ public class SLGraphics extends Graphics2D implements Cloneable {
      * <p>
      * The area inside the polygon is defined using an
      * even-odd fill rule, also known as the alternating rule.
-     * @param        xPoints   a an array of <code>x</code> coordinates.
-     * @param        yPoints   a an array of <code>y</code> coordinates.
-     * @param        nPoints   a the total number of points.
+     * @param        xPoints   an array of <code>x</code> coordinates.
+     * @param        yPoints   an array of <code>y</code> coordinates.
+     * @param        nPoints   the total number of points.
      * @see          Graphics#drawPolygon(int[], int[], int)
      */
     public void fillPolygon(int[] xPoints, int[] yPoints,
@@ -994,9 +994,9 @@ public class SLGraphics extends Graphics2D implements Cloneable {
      * 1&nbsp;&le;&nbsp;<i>i</i>&nbsp;&le;&nbsp;<code>nPoints</code>.
      * The figure is automatically closed by drawing a line connecting
      * the final point to the first point, if those points are different.
-     * @param        xPoints   a an array of <code>x</code> coordinates.
-     * @param        yPoints   a an array of <code>y</code> coordinates.
-     * @param        nPoints   a the total number of points.
+     * @param        xPoints   an array of <code>x</code> coordinates.
+     * @param        yPoints   an array of <code>y</code> coordinates.
+     * @param        nPoints   the total number of points.
      * @see          Graphics#fillPolygon(int[],int[],int)
      * @see          Graphics#drawPolyline
      */
diff --git a/poi/src/main/java/org/apache/poi/sl/draw/geom/IAdjustableShape.java b/poi/src/main/java/org/apache/poi/sl/draw/geom/IAdjustableShape.java
index 7d6a2d1102..ea4768c541 100644
--- a/poi/src/main/java/org/apache/poi/sl/draw/geom/IAdjustableShape.java
+++ b/poi/src/main/java/org/apache/poi/sl/draw/geom/IAdjustableShape.java
@@ -28,7 +28,7 @@ package org.apache.poi.sl.draw.geom;
 public interface IAdjustableShape {
     /**
      *
-     * @param  name name of a adjust value, e.g. adj1
+     * @param  name name of an adjust value, e.g. adj1
      * @return adjust guide defined in the shape or null
      */
     GuideIf getAdjustValue(String name);
diff --git a/poi/src/main/java/org/apache/poi/ss/format/CellElapsedFormatter.java b/poi/src/main/java/org/apache/poi/ss/format/CellElapsedFormatter.java
index 1505ba6f28..43069d2eab 100644
--- a/poi/src/main/java/org/apache/poi/ss/format/CellElapsedFormatter.java
+++ b/poi/src/main/java/org/apache/poi/ss/format/CellElapsedFormatter.java
@@ -124,7 +124,7 @@ public class CellElapsedFormatter extends CellFormatter {
     }
 
     /**
-     * Creates a elapsed time formatter.
+     * Creates an elapsed time formatter.
      *
      * @param pattern The pattern to parse.
      */
diff --git a/poi/src/main/java/org/apache/poi/ss/formula/atp/NetworkdaysFunction.java b/poi/src/main/java/org/apache/poi/ss/formula/atp/NetworkdaysFunction.java
index da57eef5e1..bdcf7901bd 100644
--- a/poi/src/main/java/org/apache/poi/ss/formula/atp/NetworkdaysFunction.java
+++ b/poi/src/main/java/org/apache/poi/ss/formula/atp/NetworkdaysFunction.java
@@ -51,7 +51,7 @@ final class NetworkdaysFunction implements FreeRefFunction {
     }
 
     /**
-     * Evaluate for NETWORKDAYS. Given two dates and a optional date or interval of holidays, determines how many working days are there
+     * Evaluate for NETWORKDAYS. Given two dates and an optional date or interval of holidays, determines how many working days are there
      * between those dates.
      *
      * @return {@link ValueEval} for the number of days between two dates.
diff --git a/poi/src/main/java/org/apache/poi/ss/formula/ptg/DeletedArea3DPtg.java b/poi/src/main/java/org/apache/poi/ss/formula/ptg/DeletedArea3DPtg.java
index fb3aed7c91..629db662a3 100644
--- a/poi/src/main/java/org/apache/poi/ss/formula/ptg/DeletedArea3DPtg.java
+++ b/poi/src/main/java/org/apache/poi/ss/formula/ptg/DeletedArea3DPtg.java
@@ -29,7 +29,7 @@ import org.apache.poi.util.LittleEndianOutput;
 
 /**
  * Deleted Area 3D Ptg - 3D referecnce (Sheet + Area)<p>
- * Defined a area in Extern Sheet.
+ * Defined an area in Extern Sheet.
  *
  * @version 1.0-pre
  */
diff --git a/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java b/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java
index d458027bc7..bca5856903 100644
--- a/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java
+++ b/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java
@@ -330,7 +330,7 @@ public interface Cell {
      void setCellValue(boolean value);
 
     /**
-     * Set a error value for the cell
+     * Set an error value for the cell
      *
      * @param value the error value to set this cell to.  For formulas, we'll set the
      *        precalculated value , for errors we'll set
diff --git a/poi/src/main/java/org/apache/poi/util/GenericRecordJsonWriter.java b/poi/src/main/java/org/apache/poi/util/GenericRecordJsonWriter.java
index f282907c94..370a02f672 100644
--- a/poi/src/main/java/org/apache/poi/util/GenericRecordJsonWriter.java
+++ b/poi/src/main/java/org/apache/poi/util/GenericRecordJsonWriter.java
@@ -76,7 +76,7 @@ public class GenericRecordJsonWriter implements Closeable {
          * @param name the name of the property
          * @param object the value of the property
          * @return {@code true}, if the element was handled and output produced,
-         *   The provided methods can be overridden and a implementation can return {@code false},
+         *   The provided methods can be overridden and an implementation can return {@code false},
          *   if the element hasn't been written to the stream
          */
         boolean print(GenericRecordJsonWriter record, String name, Object object);
diff --git a/poi/src/main/java/org/apache/poi/util/GenericRecordXmlWriter.java b/poi/src/main/java/org/apache/poi/util/GenericRecordXmlWriter.java
index 793c1e845f..b812a3d31c 100644
--- a/poi/src/main/java/org/apache/poi/util/GenericRecordXmlWriter.java
+++ b/poi/src/main/java/org/apache/poi/util/GenericRecordXmlWriter.java
@@ -68,7 +68,7 @@ public class GenericRecordXmlWriter implements Closeable {
          * @param name the name of the property
          * @param object the value of the property
          * @return {@code true}, if the element was handled and output produced,
-         *   The provided methods can be overridden and a implementation can return {@code false},
+         *   The provided methods can be overridden and an implementation can return {@code false},
          *   if the element hasn't been written to the stream
          */
         boolean print(GenericRecordXmlWriter record, String name, Object object);
diff --git a/poi/src/test/java/org/apache/poi/hssf/model/TestDrawingShapes.java b/poi/src/test/java/org/apache/poi/hssf/model/TestDrawingShapes.java
index 1ca797067f..070ee25161 100644
--- a/poi/src/test/java/org/apache/poi/hssf/model/TestDrawingShapes.java
+++ b/poi/src/test/java/org/apache/poi/hssf/model/TestDrawingShapes.java
@@ -274,7 +274,7 @@ class TestDrawingShapes {
     }
 
 
-    /* assert shape properties when reading shapes from a existing workbook */
+    /* assert shape properties when reading shapes from an existing workbook */
     @Test
     void testReadExistingRectangle() throws IOException {
         try (HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("drawings.xls")) {
diff --git a/poi/src/test/java/org/apache/poi/hssf/usermodel/TestOLE2Embeding.java b/poi/src/test/java/org/apache/poi/hssf/usermodel/TestOLE2Embedding.java
index 21007ce14d..ca892b9ca8 100644
--- a/poi/src/test/java/org/apache/poi/hssf/usermodel/TestOLE2Embeding.java
+++ b/poi/src/test/java/org/apache/poi/hssf/usermodel/TestOLE2Embedding.java
@@ -36,10 +36,10 @@ import org.apache.poi.ss.usermodel.CreationHelper;
 import org.apache.poi.util.LocaleUtil;
 import org.junit.jupiter.api.Test;
 
-final class TestOLE2Embeding {
+final class TestOLE2Embedding {
 
     @Test
-    void testEmbeding() throws Exception {
+    void testEmbedding() throws Exception {
         // This used to break, until bug #43116 was fixed
         try (HSSFWorkbook workbook = HSSFTestDataSamples.openSampleWorkbook("ole2-embedding.xls")) {
             // Check we can get at the Escher layer still
@@ -138,7 +138,7 @@ final class TestOLE2Embeding {
         UnsynchronizedByteArrayOutputStream bos = new UnsynchronizedByteArrayOutputStream();
         try (HSSFWorkbook wb = new HSSFWorkbook()) {
             HSSFSheet sheet = wb.createSheet();
-            sheet.createRow(5).createCell(2).setCellValue("yo dawg i herd you like embeddet objekts, so we put a ole in your ole so you can save a file while you save a file");
+            sheet.createRow(5).createCell(2).setCellValue("yo dawg i herd you like embeddet objekts, so we put an ole in your ole so you can save a file while you save a file");
 
             wb.write(bos);
         }
diff --git a/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestFormulaEvaluator.java b/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestFormulaEvaluator.java
index 28be1eaa1c..8f621a1428 100644
--- a/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestFormulaEvaluator.java
+++ b/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestFormulaEvaluator.java
@@ -303,7 +303,7 @@ public abstract class BaseTestFormulaEvaluator {
             try {
                 fe.evaluateInCell(cellB1);
             } catch (IllegalStateException e) {
-                if (e.getMessage().equalsIgnoreCase("Cannot get a numeric value from a error formula cell")) {
+                if (e.getMessage().equalsIgnoreCase("Cannot get a numeric value from an error formula cell")) {
                     fail("Identified bug 46479a");
                 }
             }
diff --git a/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestSheetShiftRows.java b/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestSheetShiftRows.java
index 60ceb9b3cc..b6c6330a31 100644
--- a/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestSheetShiftRows.java
+++ b/poi/src/test/java/org/apache/poi/ss/usermodel/BaseTestSheetShiftRows.java
@@ -77,7 +77,7 @@ public abstract class BaseTestSheetShiftRows {
                 assertEquals(5, s.getRow(4).getPhysicalNumberOfCells());
 
                 // Shift rows 1-3 down 3 in the current one.  This tests when
-                // 1 row is blank.  Write to a another temp file
+                // 1 row is blank.  Write to another temp file
                 s.shiftRows(0, 2, 3);
                 try (Workbook wb3 = _testDataProvider.writeOutAndReadBack(wb2)) {
                     // Read and ensure things are where they should be