use 'its'

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

jenkins/create_jobs.groovy

@@ -691,7 +691,7 @@ Unfortunately we often see builds break because of changes/new machines...''')
                 'adoptopenjdk_hotspot_8u282',
                 'ibmjdk_1.8.0_261'
         )
-        // Note H50 is reserved according to it's node-descripion
+        // Note H50 is reserved according to its node-description
         label('Nodes','H22','H23','H24','H25','H26','H27','H28','H29','H30','H31','H32','H33','H34','H35','H36','H37','H38','H39','H40','H41','H42','H43','H44','H48','lucene1','lucene2','master')
     }
     steps {

poi-examples/src/main/java/org/apache/poi/examples/ss/AddDimensionedImage.java

@@ -135,7 +135,7 @@ import java.util.Locale;
  * <p>
  * Note that the final four method calls all pass the same value and seem to
  * indicate that the images top left hand corner is aligned with the top left
- * hand corner of cell A1 and that it's bottom right hand corner is also
+ * hand corner of cell A1 and that its bottom right hand corner is also
  * aligned with the top left hand corner of cell A1. Yet, running this code
  * would see the image fully occupying cell A1. That is the result of the
  * values passed to parameters three and four; these I have referred to as
@@ -406,7 +406,7 @@ public class AddDimensionedImage {
      * the image, adjusts the columns width if necessary and creates then
      * returns a ClientAnchorDetail object that facilitates construction of
      * an ClientAnchor that will fix the image on the sheet and establish
-     * it's size.
+     * its size.
      *
      * @param sheet           A reference to the sheet that will 'contain' the image.
      * @param colNumber       A primitive int that contains the index number of a
@@ -483,7 +483,7 @@ public class AddDimensionedImage {
                 // Mow many co-ordinate positions are there per millimetre?
                 colCoordinatesPerMM = ConvertImageUnits.TOTAL_COLUMN_COORDINATE_POSITIONS /
                         colWidthMM;
-                // Given the width of the image, what should be it's co-ordinate?
+                // Given the width of the image, what should be its co-ordinate?
                 pictureWidthCoordinates = (int) (reqImageWidthMM * colCoordinatesPerMM);
             } else {
                 pictureWidthCoordinates = (int) reqImageWidthMM *
@@ -500,7 +500,7 @@ public class AddDimensionedImage {
      * the image, adjusts the rows height if necessary and creates then
      * returns a ClientAnchorDetail object that facilitates construction of
      * a ClientAnchor that will fix the image on the sheet and establish
-     * it's size.
+     * its size.
      *
      * @param sheet            A reference to the sheet that will 'contain' the image.
      * @param rowNumber        A primitive int that contains the index number of a
@@ -528,7 +528,7 @@ public class AddDimensionedImage {
         int pictureHeightCoordinates;
         ClientAnchorDetail rowClientAnchorDetail = null;
 
-        // Get the row and it's height
+        // Get the row and its height
         row = sheet.getRow(rowNumber);
         if (row == null) {
             // Create row if it does not exist.
@@ -624,7 +624,7 @@ public class AddDimensionedImage {
             colWidthMM = ConvertImageUnits.widthUnits2Millimetres(
                     (short) (sheet.getColumnWidth(toColumn)));
             // Note use of the cell border width constant. Testing with an image
-            // declared to fit exactly into one column demonstrated that it's
+            // declared to fit exactly into one column demonstrated that its
             // width was greater than the width of the column the POI returned.
             // Further, this difference was a constant value that I am assuming
             // related to the cell's borders. Either way, that difference needs

poi-examples/src/main/java/org/apache/poi/examples/ss/LinkedDropDownLists.java

@@ -77,7 +77,7 @@ public class LinkedDropDownLists {
             LinkedDropDownLists.buildDataSheet(sheet);
 
             // Build the first data validation to occupy cell A1. Note
-            // that it retrieves it's data from the named area or region called
+            // that it retrieves its data from the named area or region called
             // CHOICES. Further information about this can be found in the
             // static buildDataSheet() method below.
             CellRangeAddressList addressList = new CellRangeAddressList(0, 0, 0, 0);

poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java

@@ -327,7 +327,7 @@ public class ToCSV {
         }
 
         // Step through each of the files in the source folder and for each
-        // open the workbook, convert it's contents to CSV format and then
+        // open the workbook, convert its contents to CSV format and then
         // save the resulting file away into the folder specified by the
         // contents of the destination variable. Note that the name of the
         // csv file will be created by taking the name of the Excel file,
@@ -342,7 +342,7 @@ public class ToCSV {
                 // Open the workbook
                 this.openWorkbook(excelFile);
 
-                // Convert it's contents into a CSV file
+                // Convert its contents into a CSV file
                 this.convertToCSV();
 
                 // Build the name of the csv folder from that of the Excel workbook.
@@ -451,7 +451,7 @@ public class ToCSV {
                 // from this 'row' ArrayList one at a time and to write the Strings
                 // away to a StringBuilder thus assembling a single line for inclusion
                 // in the CSV file. If a row was empty or if it was short, then
-                // the ArrayList that contains it's data will also be shorter than
+                // the ArrayList that contains its data will also be shorter than
                 // some of the others. Therefore, it is necessary to check within
                 // the for loop to ensure that the ArrayList contains data to be
                 // processed. If it does, then an element will be recovered and

poi-examples/src/main/java/org/apache/poi/examples/xslf/AddVideoToPptx.java.txt

@@ -236,7 +236,7 @@ public class AddVideoToPptx {
             if (mLastPtsWrite == Global.NO_PTS)
                 mLastPtsWrite = Math.max(0, evtTS - MICRO_SECONDS_BETWEEN_FRAMES);
 
-            // if it's time to write the next frame
+            // if its time to write the next frame
             if (evtTS - mLastPtsWrite >= MICRO_SECONDS_BETWEEN_FRAMES) {
                 if (!hasFired) {
                     image = event.getImage();

poi-excelant/src/main/java/org/apache/poi/ss/excelant/ExcelAntHandlerTask.java

@@ -37,7 +37,7 @@ import org.apache.tools.ant.Task;
  * <p>
  * In order to use this tag you must write a class that implements the
  * {@code IExcelAntWorkbookHandler} interface.  After writing the
- * class you should package it and it's dependencies into a jar file to
+ * class you should package it and its dependencies into a jar file to
  * add as library in your Ant build file.
  */
 public class ExcelAntHandlerTask extends Task {

poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java

@@ -509,7 +509,7 @@ public class XMLSlideShow extends POIXMLDocument
             if (shape instanceof XSLFGroupShape) {
                 removePictureRelations(slide, (XSLFGroupShape)shape, picture);
             }
-            // ... or the picture shape with this picture data and remove it's relation to the picture data.
+            // ... or the picture shape with this picture data and remove its relation to the picture data.
             if (shape instanceof XSLFPictureShape) {
                 XSLFPictureShape pic = (XSLFPictureShape) shape;
                 if (pic.getPictureData() == picture) {

poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFShape.java

@@ -106,7 +106,7 @@ public abstract class XSLFShape implements Shape<XSLFShape,XSLFTextParagraph> {
      */
     public final XmlObject getXmlObject() {
         // it's final because the xslf inheritance hierarchy is not necessary the same as
-        // the (not existing) xmlbeans hierarchy and subclasses shouldn't narrow it's return value
+        // the (not existing) xmlbeans hierarchy and subclasses shouldn't narrow its return value
         return _shape;
     }
 

poi-ooxml/src/main/java/org/apache/poi/xssf/model/MapInfo.java

@@ -104,7 +104,7 @@ public class MapInfo extends POIXMLDocumentPart {
     /**
      * Gets the
      * @param schemaId the schema ID
-     * @return CTSchema by it's ID
+     * @return CTSchema by its ID
      */
     public CTSchema getCTSchemaById(String schemaId){
         CTSchema xmlSchema = null;

poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFHyperlink.java

@@ -67,7 +67,7 @@ public class XSSFHyperlink implements Hyperlink, Duplicatable {
         // Figure out the Hyperlink type and destination
 
         if (_externalRel == null) {
-            // If it has a location, it's internal
+            // If it has a location, its internal
             if (ctHyperlink.getLocation() != null) {
                 _type = HyperlinkType.DOCUMENT;
                 _location = ctHyperlink.getLocation();

poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFSheet.java

@@ -4646,7 +4646,7 @@ public class XSSFSheet extends POIXMLDocumentPart implements Sheet, OoxmlSheetEx
 
         pivotTable.setPivotCacheDefinition(pivotCacheDefinition);
 
-        //Create pivotCache and sets up it's relationship with the workbook
+        //Create pivotCache and sets up its relationship with the workbook
         pivotTable.setPivotCache(new XSSFPivotCache(workbook.addPivotCache(rId)));
 
         //Create relationship between pivotcacherecord and pivotcachedefinition

poi/src/main/java/org/apache/poi/hssf/usermodel/EscherGraphics.java

@@ -38,7 +38,7 @@ import java.text.AttributedCharacterIterator;
  * One important concept worth considering is that of font size.  One of the
  * difficulties in converting Graphics calls into escher drawing calls is that
  * Excel does not have the concept of absolute pixel positions.  It measures
- * it's cell widths in 'characters' and the cell heights in points.
+ * its cell widths in 'characters' and the cell heights in points.
  * Unfortunately it's not defined exactly what a type of character it's
  * measuring.  Presumably this is due to the fact that the Excel will be
  * using different fonts on different platforms or even within the same

poi/src/main/java/org/apache/poi/hssf/usermodel/EscherGraphics2d.java

@@ -49,7 +49,7 @@ import java.util.Map;
  * One important concept worth considering is that of font size.  One of the
  * difficulties in converting Graphics calls into escher drawing calls is that
  * Excel does not have the concept of absolute pixel positions.  It measures
- * it's cell widths in 'characters' and the cell heights in points.
+ * its cell widths in 'characters' and the cell heights in points.
  * Unfortunately it's not defined exactly what a type of character it's
  * measuring.  Presumably this is due to the fact that the Excel will be
  * using different fonts on different platforms or even within the same

poi/src/main/java/org/apache/poi/poifs/crypt/EncryptionInfo.java

@@ -160,7 +160,7 @@ public class EncryptionInfo implements GenericRecord {
      * Constructs an EncryptionInfo from scratch
      *
      * @param encryptionMode see {@link EncryptionMode} for values, {@link EncryptionMode#cryptoAPI} is for
-     *   internal use only, as it's record based
+     *   internal use only, as its record based
      * @param cipherAlgorithm the cipher algorithm
      * @param hashAlgorithm the hash algorithm
      * @param keyBits the bit count of the key

poi/src/main/java/org/apache/poi/poifs/filesystem/Ole10Native.java

@@ -37,7 +37,7 @@ import org.apache.poi.util.StringUtil;
  *
  * Ole10Native objects come in different shapes:
  * <ul>
- *     <li>unparsed: we can't identify it's structure</li>
+ *     <li>unparsed: we can't identify its structure</li>
  *     <li>compact: same as unparsed but with a leading flag</li>
  *     <li>parsed - Ole-Class "Package": data + ASCII label,command,filename</li>
  *     <li>parsed - Ole-Class "Package2": as above plus UTF16 label,command,filename</li>

poi/src/main/java/org/apache/poi/sl/usermodel/FillStyle.java

@@ -18,7 +18,7 @@
 package org.apache.poi.sl.usermodel;
 
 /**
- * This interface is the counterpart to {@link StrokeStyle} - it's specifies the filling of a shape
+ * This interface is the counterpart to {@link StrokeStyle} - it specifies the filling of a shape
  */
 public interface FillStyle {
     PaintStyle getPaint();

poi/src/main/java/org/apache/poi/sl/usermodel/TextParagraph.java

@@ -375,7 +375,7 @@ public interface TextParagraph<
 
 
     /**
-     * Get the {@link TabStop TabStops} - the list can't be and it's entries shouldn't be modified.
+     * Get the {@link TabStop TabStops} - the list can't be and its entries shouldn't be modified.
      * Opposed to other properties, this method is not cascading to the master sheet,
      * if the property is not defined on the normal slide level, i.e. the tabstops on
      * different levels aren't merged.

poi/src/main/java/org/apache/poi/ss/util/SheetUtil.java

@@ -225,7 +225,7 @@ public class SheetUtil {
         final Rectangle2D bounds;
         if(style.getRotation() != 0){
             /*
-             * Transform the text using a scale so that it's height is increased by a multiple of the leading,
+             * Transform the text using a scale so that its height is increased by a multiple of the leading,
              * and then rotate the text before computing the bounds. The scale results in some whitespace around
              * the unrotated top and bottom of the text that normally wouldn't be present if unscaled, but
              * is added by the standard Excel autosize.

poi/src/main/java/org/apache/poi/ss/util/cellwalk/CellWalkContext.java

@@ -22,7 +22,7 @@ public interface CellWalkContext {
     /**
      * Returns ordinal number of cell in range.  Numeration starts
      * from top left cell and ends at bottom right cell. Here is a
-     * brief example (number in cell is it's ordinal number):
+     * brief example (number in cell is its ordinal number):
      *
      * <table>
      *   <caption>ordinal number example</caption>