svn commit: r1896139 [1/2] - in /poi/trunk: poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/ poi-ooxml/src/main/java/org/apache/poi/ooxml/ poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/ poi-ooxml/src/main/java/org/apache/p...

[fa...@apache.org]

Author: fanningpj
Date: Sat Dec 18 17:41:36 2021
New Revision: 1896139

URL: http://svn.apache.org/viewvc?rev=1896139&view=rev
Log:
code tidy up

Modified:
    poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/ooxml/POIXMLDocument.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/PackagePartCollection.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/internal/ContentTypeManager.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFCell.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
    poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCell.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/HMEFMessage.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideShow.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hsmf/MAPIMessage.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwmf/usermodel/HwmfPicture.java
    poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/HWPFDocument.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/ClassID.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/DocumentSummaryInformation.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Property.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySet.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySetFactory.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Section.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/SummaryInformation.java
    poi/trunk/poi/src/main/java/org/apache/poi/hpsf/VariantSupport.java
    poi/trunk/poi/src/main/java/org/apache/poi/hssf/eventmodel/EventRecordFactory.java
    poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordFactory.java
    poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/eventfilesystem/POIFSReader.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryEntry.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryNode.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DocumentInputStream.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/DirectoryProperty.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Parent.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Property.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BATBlock.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BlockWritable.java
    poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/HeaderBlock.java
    poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java
    poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/DateUtil.java
    poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Workbook.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/ByteField.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/CodePageUtil.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/FixedField.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/HexDump.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/IntList.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/IntegerField.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndian.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndianInputStream.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/LongField.java
    poi/trunk/poi/src/main/java/org/apache/poi/util/ShortField.java
    poi/trunk/poi/src/test/java/org/apache/poi/hpsf/basic/TestBasic.java
    poi/trunk/poi/src/test/java/org/apache/poi/hpsf/basic/TestEmptyProperties.java
    poi/trunk/poi/src/test/java/org/apache/poi/hpsf/basic/TestUnicode.java
    poi/trunk/poi/src/test/java/org/apache/poi/hpsf/basic/TestWrite.java
    poi/trunk/poi/src/test/java/org/apache/poi/hpsf/basic/Util.java
    poi/trunk/poi/src/test/java/org/apache/poi/hssf/dev/BiffViewer.java
    poi/trunk/src/resources/devtools/poi.jin

Modified: poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java (original)
+++ poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java Sat Dec 18 17:41:36 2021
@@ -191,7 +191,7 @@ public class XLSX2CSV {
      * @param strings The table of strings that may be referenced by cells in the sheet
      * @param sheetInputStream The stream to read the sheet-data from.
 
-     * @exception java.io.IOException An IO exception from the parser,
+     * @throws java.io.IOException An IO exception from the parser,
      *            possibly from a byte stream or character stream
      *            supplied by the application.
      * @throws SAXException if parsing the XML data fails.

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/ooxml/POIXMLDocument.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/ooxml/POIXMLDocument.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/ooxml/POIXMLDocument.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/ooxml/POIXMLDocument.java Sat Dec 18 17:41:36 2021
@@ -81,7 +81,7 @@ public abstract class POIXMLDocument ext
      * @param path the path to the document
      * @return the new OPCPackage
      *
-     * @exception IOException if there was a problem opening the document
+     * @throws IOException if there was a problem opening the document
      */
     public static OPCPackage openPackage(String path) throws IOException {
         try {
@@ -206,7 +206,7 @@ public abstract class POIXMLDocument ext
      *
      * @param stream - the java OutputStream you wish to write the file to
      *
-     * @exception IOException if anything can't be written.
+     * @throws IOException if anything can't be written.
      */
     @SuppressWarnings("resource")
     public final void write(OutputStream stream) throws IOException {

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/PackagePartCollection.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/PackagePartCollection.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/PackagePartCollection.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/PackagePartCollection.java Sat Dec 18 17:41:36 2021
@@ -57,7 +57,7 @@ public final class PackagePartCollection
      * @param part part to put
      * @return the previous value associated with {@code partName}, or
      *         {@code null} if there was no mapping for {@code partName}.
-     * @exception InvalidOperationException
+     * @throws InvalidOperationException
      *                Throws if you try to add a part with a name derived from
      *                another part name.
      */

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/internal/ContentTypeManager.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/internal/ContentTypeManager.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/internal/ContentTypeManager.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/openxml4j/opc/internal/ContentTypeManager.java Sat Dec 18 17:41:36 2021
@@ -208,7 +208,7 @@ public abstract class ContentTypeManager
      * @param partName
      *            The part URI associated with the override content type to
      *            delete.
-     * @exception InvalidOperationException
+     * @throws InvalidOperationException
      *                Throws if
      */
     public void removeContentType(PackagePartName partName)
@@ -323,7 +323,7 @@ public abstract class ContentTypeManager
      *         content type) or the extension (in case of default content type),
      *         else <code>null</code>.
      *
-     * @exception OpenXML4JRuntimeException
+     * @throws OpenXML4JRuntimeException
      *                Throws if the content type manager is not able to find the
      *                content from an existing part.
      */

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFCell.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFCell.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFCell.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFCell.java Sat Dec 18 17:41:36 2021
@@ -309,7 +309,7 @@ public class SXSSFCell extends CellBase
      * </p>
      * @return the value of the cell as a number
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CellType.STRING
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see org.apache.poi.ss.usermodel.DataFormatter for turning this number into a string similar to that which Excel would render this number as.
      */
     @Override
@@ -341,7 +341,7 @@ public class SXSSFCell extends CellBase
      * </p>
      * @return the value of the cell as a date
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CellType.STRING
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see org.apache.poi.ss.usermodel.DataFormatter for formatting  this date into a string similar to how excel does.
      */
     @Override
@@ -365,7 +365,7 @@ public class SXSSFCell extends CellBase
      * </p>
      * @return the value of the cell as a date
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CellType.STRING
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see org.apache.poi.ss.usermodel.DataFormatter for formatting  this date into a string similar to how excel does.
      */
     @Override

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java Sat Dec 18 17:41:36 2021
@@ -949,7 +949,7 @@ public class SXSSFWorkbook implements Wo
      * Write out this workbook to an OutputStream.
      *
      * @param stream - the java OutputStream you wish to write to
-     * @exception IOException if anything can't be written.
+     * @throws IOException if anything can't be written.
      */
     @Override
     public void write(OutputStream stream) throws IOException {
@@ -982,7 +982,7 @@ public class SXSSFWorkbook implements Wo
      * so using this does not guarantee that there will be no temp file usage.
      *
      * @param stream - the java OutputStream you wish to write to
-     * @exception IOException if anything can't be written.
+     * @throws IOException if anything can't be written.
      * @since POI 5.1.0 (experimental and still liable to change or be removed)
      */
     @Beta

Modified: poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCell.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCell.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCell.java (original)
+++ poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFCell.java Sat Dec 18 17:41:36 2021
@@ -230,7 +230,7 @@ public final class XSSFCell extends Cell
      * </p>
      * @return the value of the cell as a number
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable {@code double}.
+     * @throws NumberFormatException if the cell value isn't a parsable {@code double}.
      * @see DataFormatter for turning this number into a string similar to that which Excel would render this number as.
      */
     @Override
@@ -671,7 +671,7 @@ public final class XSSFCell extends Cell
      * </p>
      * @return the value of the cell as a date
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable {@code double}.
+     * @throws NumberFormatException if the cell value isn't a parsable {@code double}.
      * @see DataFormatter for formatting  this date into a string similar to how excel does.
      */
     @Override
@@ -692,7 +692,7 @@ public final class XSSFCell extends Cell
      * </p>
      * @return the value of the cell as a LocalDateTime
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable {@code double}.
+     * @throws NumberFormatException if the cell value isn't a parsable {@code double}.
      * @see DataFormatter for formatting  this date into a string similar to how excel does.
      */
     @Override

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/HMEFMessage.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/HMEFMessage.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/HMEFMessage.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/HMEFMessage.java Sat Dec 18 17:41:36 2021
@@ -47,7 +47,13 @@ public final class HMEFMessage {
     private final List<TNEFAttribute> messageAttributes = new ArrayList<>();
     private final List<MAPIAttribute> mapiAttributes = new ArrayList<>();
     private final List<Attachment> attachments = new ArrayList<>();
-    
+
+    /**
+     * @param inp input stream
+     * @throws IOException
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
+     */
     public HMEFMessage(InputStream inp) throws IOException {
         try {
             // Check the signature matches

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideShow.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideShow.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideShow.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideShow.java Sat Dec 18 17:41:36 2021
@@ -166,6 +166,9 @@ public final class HSLFSlideShow extends
 
     /**
      * Constructs a Powerpoint document from an input stream.
+     * @throws IOException
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     @SuppressWarnings("resource")
     public HSLFSlideShow(InputStream inputStream) throws IOException {
@@ -174,6 +177,9 @@ public final class HSLFSlideShow extends
 
     /**
      * Constructs a Powerpoint document from an POIFSFileSystem.
+     * @throws IOException
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     @SuppressWarnings("resource")
     public HSLFSlideShow(POIFSFileSystem poifs) throws IOException {
@@ -182,6 +188,9 @@ public final class HSLFSlideShow extends
 
     /**
      * Constructs a Powerpoint document from an DirectoryNode.
+     * @throws IOException
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     @SuppressWarnings("resource")
     public HSLFSlideShow(DirectoryNode root) throws IOException {

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hsmf/MAPIMessage.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hsmf/MAPIMessage.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hsmf/MAPIMessage.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hsmf/MAPIMessage.java Sat Dec 18 17:41:36 2021
@@ -103,7 +103,9 @@ public class MAPIMessage extends POIRead
     * Constructor for reading MSG Files from the file system.
     *
     * @param filename Name of the file to read
-    * @exception IOException on errors reading, or invalid data
+    * @throws IOException on errors reading, or invalid data
+    * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+    * input format
     */
    public MAPIMessage(String filename) throws IOException {
       this(new File(filename));
@@ -112,7 +114,9 @@ public class MAPIMessage extends POIRead
     * Constructor for reading MSG Files from the file system.
     *
     * @param file The file to read from
-    * @exception IOException on errors reading, or invalid data
+    * @throws IOException on errors reading, or invalid data
+    * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+    * input format
     */
    public MAPIMessage(File file) throws IOException {
       this(new POIFSFileSystem(file));
@@ -124,8 +128,10 @@ public class MAPIMessage extends POIRead
     * <p>Note - this will buffer the whole message into memory
     *  in order to process. For lower memory use, use {@link #MAPIMessage(File)}
     *
-    * @param in The InputStream to buffer then read from
-    * @exception IOException on errors reading, or invalid data
+    * @param in The InputStream to buffer and then read from
+    * @throws IOException on errors reading, or invalid data
+    * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+    * input format
     */
    public MAPIMessage(InputStream in) throws IOException {
       this(new POIFSFileSystem(in));
@@ -134,7 +140,9 @@ public class MAPIMessage extends POIRead
     * Constructor for reading MSG Files from a POIFS filesystem
     *
     * @param fs Open POIFS FileSystem containing the message
-    * @exception IOException on errors reading, or invalid data
+    * @throws IOException on errors reading, or invalid data
+    * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+    * input format
     */
    public MAPIMessage(POIFSFileSystem fs) throws IOException {
       this(fs.getRoot());
@@ -143,7 +151,9 @@ public class MAPIMessage extends POIRead
     * Constructor for reading MSG Files from a certain
     *  point within a POIFS filesystem
     * @param poifsDir Directory containing the message
-    * @exception IOException on errors reading, or invalid data
+    * @throws IOException on errors reading, or invalid data
+    * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+    * input format
     */
    public MAPIMessage(DirectoryNode poifsDir) throws IOException {
       super(poifsDir);

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java Sat Dec 18 17:41:36 2021
@@ -104,6 +104,8 @@ public class ExcelToHtmlConverter extend
      * @return DOM representation of result HTML
      * @throws IOException                  If an error occurs reading or writing files
      * @throws ParserConfigurationException If configuration is incorrect
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public static Document process(File xlsFile) throws IOException, ParserConfigurationException {
         try (HSSFWorkbook workbook = loadXls(xlsFile)) {
@@ -118,6 +120,8 @@ public class ExcelToHtmlConverter extend
      * @return DOM representation of result HTML
      * @throws IOException                  If an error occurs reading or writing files
      * @throws ParserConfigurationException If configuration is incorrect
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public static Document process(InputStream xlsStream) throws IOException, ParserConfigurationException {
         try (HSSFWorkbook workbook = new HSSFWorkbook(xlsStream)) {
@@ -132,6 +136,8 @@ public class ExcelToHtmlConverter extend
      * @return DOM representation of result HTML
      * @throws IOException                  If an error occurs reading or writing files
      * @throws ParserConfigurationException If configuration is incorrect
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public static Document process(HSSFWorkbook workbook) throws IOException, ParserConfigurationException {
         ExcelToHtmlConverter excelToHtmlConverter = new ExcelToHtmlConverter(

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwmf/usermodel/HwmfPicture.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwmf/usermodel/HwmfPicture.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwmf/usermodel/HwmfPicture.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwmf/usermodel/HwmfPicture.java Sat Dec 18 17:41:36 2021
@@ -80,6 +80,12 @@ public class HwmfPicture implements Iter
         return MAX_RECORD_LENGTH;
     }
 
+    /**
+     * @param inputStream
+     * @throws IOException
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
+     */
     public HwmfPicture(InputStream inputStream) throws IOException {
 
         try (LittleEndianInputStream leis = new LittleEndianInputStream(inputStream)) {

Modified: poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/HWPFDocument.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/HWPFDocument.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/HWPFDocument.java (original)
+++ poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/HWPFDocument.java Sat Dec 18 17:41:36 2021
@@ -215,6 +215,8 @@ public final class HWPFDocument extends
      * @throws IOException If there is an unexpected IOException from the passed
      *                     in InputStream.
 	 * @throws org.apache.poi.EmptyFileException If the given stream is empty
+     * @throws RuntimeException a number of other runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public HWPFDocument(InputStream istream) throws IOException {
         //do Ole stuff
@@ -227,6 +229,8 @@ public final class HWPFDocument extends
      * @param pfilesystem The POIFSFileSystem that contains the Word document.
      * @throws IOException If there is an unexpected IOException from the passed
      *                     in POIFSFileSystem.
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public HWPFDocument(POIFSFileSystem pfilesystem) throws IOException {
         this(pfilesystem.getRoot());
@@ -240,6 +244,8 @@ public final class HWPFDocument extends
      * @param directory The DirectoryNode that contains the Word document.
      * @throws IOException If there is an unexpected IOException from the passed
      *                     in POIFSFileSystem.
+     * @throws RuntimeException a number of runtime exceptions can be thrown, especially if there are problems with the
+     * input format
      */
     public HWPFDocument(DirectoryNode directory) throws IOException {
         // Load the main stream and FIB

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/ClassID.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/ClassID.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/ClassID.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/ClassID.java Sat Dec 18 17:41:36 2021
@@ -162,7 +162,7 @@ public class ClassID implements Duplicat
      *
      * @param offset The offset within the {@code dst} byte array.
      *
-     * @exception ArrayStoreException if there is not enough room for the class
+     * @throws ArrayStoreException if there is not enough room for the class
      * ID 16 bytes in the byte array after the {@code offset} position.
      */
     @SuppressWarnings("PointlessArithmeticExpression")

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/DocumentSummaryInformation.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/DocumentSummaryInformation.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/DocumentSummaryInformation.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/DocumentSummaryInformation.java Sat Dec 18 17:41:36 2021
@@ -97,7 +97,7 @@ public class DocumentSummaryInformation
      * stream.
      * @throws IOException
      *    if the {@link InputStream} cannot be accessed as needed.
-     * @exception NoPropertySetStreamException
+     * @throws NoPropertySetStreamException
      *    if the input stream does not contain a property set.
      */
     public DocumentSummaryInformation(final InputStream stream)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Property.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Property.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Property.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Property.java Sat Dec 18 17:41:36 2021
@@ -125,7 +125,7 @@ public class Property {
      * @param length The property's type/value pair's length in bytes.
      * @param codepage The section's and thus the property's
      * codepage. It is needed only when reading string values.
-     * @exception UnsupportedEncodingException if the specified codepage is not
+     * @throws UnsupportedEncodingException if the specified codepage is not
      * supported.
      */
     public Property(final long id, final byte[] src, final long offset, final int length, final int codepage)
@@ -161,7 +161,7 @@ public class Property {
      * @param length The property's type/value pair's length in bytes.
      * @param codepage The section's and thus the property's
      * codepage. It is needed only when reading string values.
-     * @exception UnsupportedEncodingException if the specified codepage is not
+     * @throws UnsupportedEncodingException if the specified codepage is not
      * supported.
      */
     public Property(final long id, LittleEndianByteArrayInputStream leis, final int length, final int codepage)
@@ -255,7 +255,7 @@ public class Property {
      *
      * @return the property's size in bytes
      *
-     * @exception WritingNotSupportedException if HPSF does not yet support the
+     * @throws WritingNotSupportedException if HPSF does not yet support the
      * property's variant type.
      */
     protected int getSize(int property) throws WritingNotSupportedException
@@ -487,8 +487,8 @@ public class Property {
      * @param codepage The codepage to use for writing non-wide strings
      * @return the number of bytes written to the stream
      *
-     * @exception IOException if an I/O error occurs
-     * @exception WritingNotSupportedException if a variant type is to be
+     * @throws IOException if an I/O error occurs
+     * @throws WritingNotSupportedException if a variant type is to be
      * written that is not yet supported
      */
     public int write(final OutputStream out, final int codepage)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySet.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySet.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySet.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySet.java Sat Dec 18 17:41:36 2021
@@ -179,9 +179,9 @@ public class PropertySet {
      * stream.
      * @throws IOException
      *    if the {@link InputStream} cannot be accessed as needed.
-     * @exception NoPropertySetStreamException
+     * @throws NoPropertySetStreamException
      *    if the input stream does not contain a property set.
-     * @exception UnsupportedEncodingException
+     * @throws UnsupportedEncodingException
      *    if a character encoding is not supported.
      */
     public PropertySet(final InputStream stream)
@@ -208,7 +208,7 @@ public class PropertySet {
      * @throws NoPropertySetStreamException if the byte array is not a
      * property set stream.
      *
-     * @exception UnsupportedEncodingException if the codepage is not supported.
+     * @throws UnsupportedEncodingException if the codepage is not supported.
      */
     public PropertySet(final byte[] stream, final int offset, final int length)
     throws NoPropertySetStreamException, UnsupportedEncodingException {
@@ -227,7 +227,7 @@ public class PropertySet {
      * @throws NoPropertySetStreamException if the byte array is not a
      * property set stream.
      *
-     * @exception UnsupportedEncodingException if the codepage is not supported.
+     * @throws UnsupportedEncodingException if the codepage is not supported.
      */
     public PropertySet(final byte[] stream)
     throws NoPropertySetStreamException, UnsupportedEncodingException {
@@ -376,7 +376,7 @@ public class PropertySet {
      * {@link InputStream#mark} method.
      * @return {@code true} if the stream is a property set
      * stream, else {@code false}.
-     * @exception IOException if an I/O error occurs
+     * @throws IOException if an I/O error occurs
      */
     public static boolean isPropertySetStream(final InputStream stream) throws IOException {
         /*
@@ -500,9 +500,9 @@ public class PropertySet {
      * Writes the property set to an output stream.
      *
      * @param out the output stream to write the section to
-     * @exception IOException if an error when writing to the output stream
+     * @throws IOException if an error when writing to the output stream
      * occurs
-     * @exception WritingNotSupportedException if HPSF does not yet support
+     * @throws WritingNotSupportedException if HPSF does not yet support
      * writing a property's variant type.
      */
     public void write(final OutputStream out) throws IOException, WritingNotSupportedException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySetFactory.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySetFactory.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySetFactory.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/PropertySetFactory.java Sat Dec 18 17:41:36 2021
@@ -47,7 +47,7 @@ public class PropertySetFactory {
      * @throws NoPropertySetStreamException if the stream does not
      * contain a property set.
      * @throws IOException if some I/O problem occurs.
-     * @exception UnsupportedEncodingException if the specified codepage is not
+     * @throws UnsupportedEncodingException if the specified codepage is not
      * supported.
      */
     public static PropertySet create(final DirectoryEntry dir, final String name)
@@ -70,7 +70,7 @@ public class PropertySetFactory {
      * @throws NoPropertySetStreamException if the stream does not
      * contain a property set.
      * @throws IOException if some I/O problem occurs.
-     * @exception UnsupportedEncodingException if the specified codepage is not
+     * @throws UnsupportedEncodingException if the specified codepage is not
      * supported.
      */
     public static PropertySet create(final InputStream stream)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Section.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Section.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Section.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/Section.java Sat Dec 18 17:41:36 2021
@@ -116,7 +116,7 @@ public class Section {
      * @param offset The position in the stream that points to the
      * section's format ID.
      *
-     * @exception UnsupportedEncodingException if the section's codepage is not
+     * @throws UnsupportedEncodingException if the section's codepage is not
      * supported.
      */
     public Section(final byte[] src, final int offset) throws UnsupportedEncodingException {
@@ -711,8 +711,8 @@ public class Section {
      * @param out The stream to write into.
      *
      * @return The number of bytes written, i.e. the section's size.
-     * @exception IOException if an I/O error occurs
-     * @exception WritingNotSupportedException if HPSF does not yet support
+     * @throws IOException if an I/O error occurs
+     * @throws WritingNotSupportedException if HPSF does not yet support
      * writing a property's variant type.
      */
     public int write(final OutputStream out) throws WritingNotSupportedException, IOException {
@@ -855,7 +855,7 @@ public class Section {
      *
      * @param out The output stream to write to.
      * @param codepage The codepage to be used to write the dictionary items.
-     * @exception IOException if an I/O exception occurs.
+     * @throws IOException if an I/O exception occurs.
      */
     private void writeDictionary(final OutputStream out, final int codepage)
     throws IOException {
@@ -899,7 +899,7 @@ public class Section {
      *
      * @param dictionary The dictionary
      *
-     * @exception IllegalPropertySetDataException if the dictionary's key and
+     * @throws IllegalPropertySetDataException if the dictionary's key and
      * value types are not correct.
      *
      * @see Section#getDictionary()

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/SummaryInformation.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/SummaryInformation.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/SummaryInformation.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/SummaryInformation.java Sat Dec 18 17:41:36 2021
@@ -87,9 +87,9 @@ public final class SummaryInformation ex
      * stream.
      * @throws IOException
      *    if the {@link InputStream} cannot be accessed as needed.
-     * @exception NoPropertySetStreamException
+     * @throws NoPropertySetStreamException
      *    if the input stream does not contain a property set.
-     * @exception UnsupportedEncodingException
+     * @throws UnsupportedEncodingException
      *    if a character encoding is not supported.
      */
     public SummaryInformation(final InputStream stream)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hpsf/VariantSupport.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hpsf/VariantSupport.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hpsf/VariantSupport.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hpsf/VariantSupport.java Sat Dec 18 17:41:36 2021
@@ -152,9 +152,9 @@ public class VariantSupport extends Vari
      * @return A Java object that corresponds best to the variant field. For
      *         example, a VT_I4 is returned as a {@link Long}, a VT_LPSTR as a
      *         {@link String}.
-     * @exception ReadingNotSupportedException if a property is to be written
+     * @throws ReadingNotSupportedException if a property is to be written
      *            who's variant type HPSF does not yet support
-     * @exception UnsupportedEncodingException if the specified codepage is not
+     * @throws UnsupportedEncodingException if the specified codepage is not
      *            supported.
      * @see Variant
      */
@@ -268,8 +268,8 @@ public class VariantSupport extends Vari
      * @param codepage The codepage to use to write non-wide strings
      * @return The number of entities that have been written. In many cases an
      * "entity" is a byte but this is not always the case.
-     * @exception IOException if an I/O exceptions occurs
-     * @exception WritingNotSupportedException if a property is to be written
+     * @throws IOException if an I/O exceptions occurs
+     * @throws WritingNotSupportedException if a property is to be written
      * who's variant type HPSF does not yet support
      */
     public static int write(final OutputStream out, final long type,

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hssf/eventmodel/EventRecordFactory.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hssf/eventmodel/EventRecordFactory.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hssf/eventmodel/EventRecordFactory.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hssf/eventmodel/EventRecordFactory.java Sat Dec 18 17:41:36 2021
@@ -81,7 +81,7 @@ public final class EventRecordFactory {
      * @param in the InputStream from which the records will be
      *         obtained
      *
-     * @exception RecordFormatException on error processing the
+     * @throws RecordFormatException on error processing the
      *          InputStream
      */
     public void processRecords(InputStream in) throws RecordFormatException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordFactory.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordFactory.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordFactory.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordFactory.java Sat Dec 18 17:41:36 2021
@@ -160,7 +160,7 @@ public final class RecordFactory {
      *
      * @return an array of Records created from the InputStream
      *
-     * @exception org.apache.poi.util.RecordFormatException on error processing the InputStream
+     * @throws org.apache.poi.util.RecordFormatException on error processing the InputStream
      */
     public static List<org.apache.poi.hssf.record.Record> createRecords(InputStream in) throws RecordFormatException {
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/hssf/record/RecordInputStream.java Sat Dec 18 17:41:36 2021
@@ -361,7 +361,7 @@ public final class RecordInputStream imp
      *
      * @param requestedLength the length of the final string
      * @return                                     the converted string
-     * @exception  IllegalArgumentException        if len is too large (i.e.,
+     * @throws  IllegalArgumentException        if len is too large (i.e.,
      *      there is not enough data in string to create a String of that
      *      length)
      */

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/eventfilesystem/POIFSReader.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/eventfilesystem/POIFSReader.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/eventfilesystem/POIFSReader.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/eventfilesystem/POIFSReader.java Sat Dec 18 17:41:36 2021
@@ -55,7 +55,7 @@ public class POIFSReader
      *
      * @param stream the InputStream from which to read the data
      *
-     * @exception IOException on errors reading, or on invalid data
+     * @throws IOException on errors reading, or on invalid data
      */
 
     public void read(final InputStream stream) throws IOException {
@@ -69,7 +69,7 @@ public class POIFSReader
      *
      * @param poifsFile the file from which to read the data
      *
-     * @exception IOException on errors reading, or on invalid data
+     * @throws IOException on errors reading, or on invalid data
      */
     public void read(final File poifsFile) throws IOException {
         try (POIFSFileSystem poifs = new POIFSFileSystem(poifsFile, true)) {
@@ -82,7 +82,7 @@ public class POIFSReader
      *
      * @param poifs the POIFSFileSystem from which to read the data
      *
-     * @exception IOException on errors reading, or on invalid data
+     * @throws IOException on errors reading, or on invalid data
      */
     public void read(final POIFSFileSystem poifs) throws IOException {
         registryClosed = true;
@@ -100,8 +100,8 @@ public class POIFSReader
      *
      * @param listener the listener to be registered
      *
-     * @exception NullPointerException if listener is null
-     * @exception IllegalStateException if read() has already been
+     * @throws NullPointerException if listener is null
+     * @throws IllegalStateException if read() has already been
      *                                  called
      */
 
@@ -122,9 +122,9 @@ public class POIFSReader
      * @param listener the listener to be registered
      * @param name the document name
      *
-     * @exception NullPointerException if listener is null or name is
+     * @throws NullPointerException if listener is null or name is
      *                                 null or empty
-     * @exception IllegalStateException if read() has already been
+     * @throws IllegalStateException if read() has already been
      *                                  called
      */
 
@@ -141,9 +141,9 @@ public class POIFSReader
      *             assumed
      * @param name the document name
      *
-     * @exception NullPointerException if listener is null or name is
+     * @throws NullPointerException if listener is null or name is
      *                                 null or empty
-     * @exception IllegalStateException if read() has already been
+     * @throws IllegalStateException if read() has already been
      *                                  called
      */
 
@@ -176,7 +176,7 @@ public class POIFSReader
      *
      * @param args names of the files
      *
-     * @exception IOException if the files can't be read or have invalid content
+     * @throws IOException if the files can't be read or have invalid content
      */
 
     public static void main(String[] args) throws IOException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryEntry.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryEntry.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryEntry.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryEntry.java Sat Dec 18 17:41:36 2021
@@ -90,7 +90,7 @@ public interface DirectoryEntry extends
      * @return the specified Entry, if it is directly contained in
      *         this DirectoryEntry
      *
-     * @exception FileNotFoundException if no Entry with the specified
+     * @throws FileNotFoundException if no Entry with the specified
      *            name exists in this DirectoryEntry
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryNode.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryNode.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryNode.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DirectoryNode.java Sat Dec 18 17:41:36 2021
@@ -126,7 +126,7 @@ public class DirectoryNode
      *
      * @return a newly opened DocumentInputStream
      *
-     * @exception IOException if the document does not exist or the
+     * @throws IOException if the document does not exist or the
      *            name is that of a DirectoryEntry
      */
     public DocumentInputStream createDocumentInputStream(
@@ -143,7 +143,7 @@ public class DirectoryNode
      *
      * @return a newly opened DocumentInputStream or DocumentInputStream
      *
-     * @exception IOException if the document does not exist or the
+     * @throws IOException if the document does not exist or the
      *            name is that of a DirectoryEntry
      */
     public DocumentInputStream createDocumentInputStream(
@@ -166,7 +166,7 @@ public class DirectoryNode
      *
      * @return the new DocumentEntry
      *
-     * @exception IOException if the document can't be created
+     * @throws IOException if the document can't be created
      */
     DocumentEntry createDocument(final POIFSDocument document)
         throws IOException
@@ -311,7 +311,7 @@ public class DirectoryNode
      * @return the specified Entry, if it is directly contained in
      *         this DirectoryEntry
      *
-     * @exception FileNotFoundException if no Entry with the specified
+     * @throws FileNotFoundException if no Entry with the specified
      *            name exists in this DirectoryEntry
      */
 
@@ -348,7 +348,7 @@ public class DirectoryNode
      *
      * @return the new DocumentEntry
      *
-     * @exception IOException if the document can't be created
+     * @throws IOException if the document can't be created
      */
 
     @Override
@@ -368,7 +368,7 @@ public class DirectoryNode
      *
      * @return the new DocumentEntry
      *
-     * @exception IOException if the document can't be created
+     * @throws IOException if the document can't be created
      */
 
     @Override
@@ -386,7 +386,7 @@ public class DirectoryNode
      *
      * @return the new DirectoryEntry
      *
-     * @exception IOException if the directory can't be created
+     * @throws IOException if the directory can't be created
      */
 
     @Override
@@ -413,7 +413,7 @@ public class DirectoryNode
      *
      * @return the new or updated DocumentEntry
      *
-     * @exception IOException if the document can't be created or its content be replaced
+     * @throws IOException if the document can't be created or its content be replaced
      */
     @SuppressWarnings("WeakerAccess")
     public DocumentEntry createOrUpdateDocument(final String name,

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DocumentInputStream.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DocumentInputStream.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DocumentInputStream.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/DocumentInputStream.java Sat Dec 18 17:41:36 2021
@@ -66,7 +66,7 @@ public final class DocumentInputStream e
      *
      * @param document the DocumentEntry to be read
      *
-     * @exception IOException if the DocumentEntry cannot be opened (like, maybe it has
+     * @throws IOException if the DocumentEntry cannot be opened (like, maybe it has
      *                been deleted?)
      */
     public DocumentInputStream(DocumentEntry document) throws IOException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java Sat Dec 18 17:41:36 2021
@@ -59,7 +59,7 @@ public class POIFSDocumentPath {
      *      If the components parameter is null or has zero length, the POIFSDocumentPath is appropriate
      *      for a document that is in the root of a POIFSFileSystem
      *
-     * @exception IllegalArgumentException
+     * @throws IllegalArgumentException
      *      if any of the elements in the components parameter are null or have zero length
      */
     public POIFSDocumentPath(final String [] components) throws IllegalArgumentException {
@@ -72,7 +72,7 @@ public class POIFSDocumentPath {
      * @param path the existing path
      * @param components the additional subdirectory names to be added
      *
-     * @exception IllegalArgumentException
+     * @throws IllegalArgumentException
      *      if any of the Strings in components is null or zero length
      */
     public POIFSDocumentPath(final POIFSDocumentPath path, final String[] components) throws IllegalArgumentException {
@@ -134,7 +134,7 @@ public class POIFSDocumentPath {
      *
      * @return the nth component;
      *
-     * @exception ArrayIndexOutOfBoundsException if n &lt; 0 or n &gt;= length()
+     * @throws ArrayIndexOutOfBoundsException if n &lt; 0 or n &gt;= length()
      */
     public String getComponent(int n) throws ArrayIndexOutOfBoundsException {
         return components[ n ];

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/DirectoryProperty.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/DirectoryProperty.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/DirectoryProperty.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/DirectoryProperty.java Sat Dec 18 17:41:36 2021
@@ -249,7 +249,7 @@ public class DirectoryProperty extends P
      *
      * @param property the new child to be added; must not be null
      *
-     * @exception IOException if we already have a child with the same
+     * @throws IOException if we already have a child with the same
      *                        name
      */
     public void addChild(final Property property)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Parent.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Parent.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Parent.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Parent.java Sat Dec 18 17:41:36 2021
@@ -40,7 +40,7 @@ public interface Parent extends Child, I
      *
      * @param property the new child to be added; must not be null
      *
-     * @exception IOException if the Parent already has a child with
+     * @throws IOException if the Parent already has a child with
      *                        the same name
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Property.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Property.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Property.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/Property.java Sat Dec 18 17:41:36 2021
@@ -167,7 +167,7 @@ public abstract class Property implement
      * @param stream the OutputStream to which the data should be
      *               written.
      *
-     * @exception IOException on problems writing to the specified
+     * @throws IOException on problems writing to the specified
      *            stream.
      */
     public void writeData(OutputStream stream)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/property/PropertyTable.java Sat Dec 18 17:41:36 2021
@@ -64,7 +64,7 @@ public final class PropertyTable impleme
      * @param headerBlock the header block of the file
      * @param filesystem the filesystem to read from
      *
-     * @exception IOException if anything goes wrong (which should be
+     * @throws IOException if anything goes wrong (which should be
      *            a result of the input being NFG)
      */
     public PropertyTable(final HeaderBlock headerBlock, final POIFSFileSystem filesystem)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BATBlock.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BATBlock.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BATBlock.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BATBlock.java Sat Dec 18 17:41:36 2021
@@ -257,7 +257,7 @@ public final class BATBlock implements B
      * @param stream the OutputStream to which the stored data should
      *               be written
      *
-     * @exception IOException on problems writing to the specified
+     * @throws IOException on problems writing to the specified
      *            stream
      */
     public void writeBlocks(final OutputStream stream) throws IOException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BlockWritable.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BlockWritable.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BlockWritable.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/BlockWritable.java Sat Dec 18 17:41:36 2021
@@ -33,7 +33,7 @@ public interface BlockWritable {
      * @param stream the OutputStream to which the stored data should
      *               be written
      *
-     * @exception IOException on problems writing to the specified
+     * @throws IOException on problems writing to the specified
      *            stream
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/HeaderBlock.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/HeaderBlock.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/HeaderBlock.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/poifs/storage/HeaderBlock.java Sat Dec 18 17:41:36 2021
@@ -95,7 +95,7 @@ public final class HeaderBlock implement
      *
      * @param stream the source InputStream
      *
-     * @exception IOException on errors or bad data
+     * @throws IOException on errors or bad data
      */
     public HeaderBlock(InputStream stream) throws IOException {
         // Grab the first 512 bytes
@@ -366,7 +366,7 @@ public final class HeaderBlock implement
     * @param stream the OutputStream to which the stored data should
     *               be written
     *
-    * @exception IOException on problems writing to the specified
+    * @throws IOException on problems writing to the specified
     *            stream
     */
    public void writeData(final OutputStream stream) throws IOException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Cell.java Sat Dec 18 17:41:36 2021
@@ -267,7 +267,7 @@ public interface Cell {
      * </p>
      * @return the value of the cell as a number
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see DataFormatter for turning this number into a string similar to that which Excel would render this number as.
      */
     double getNumericCellValue();
@@ -279,7 +279,7 @@ public interface Cell {
      * </p>
      * @return the value of the cell as a date
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see DataFormatter for formatting  this date into a string similar to how excel does.
      */
     Date getDateCellValue();
@@ -291,7 +291,7 @@ public interface Cell {
      * </p>
      * @return the value of the cell as a LocalDateTime
      * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is {@link CellType#STRING}
-     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
+     * @throws NumberFormatException if the cell value isn't a parsable <code>double</code>.
      * @see DataFormatter for formatting  this date into a string similar to how excel does.
      */
     LocalDateTime getLocalDateTimeCellValue();

Modified: poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/DateUtil.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/DateUtil.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/DateUtil.java [UTF-8] (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/DateUtil.java [UTF-8] Sat Dec 18 17:41:36 2021
@@ -814,7 +814,7 @@ public class DateUtil {
      *
      * @return days number of days since 1900/12/31
      * @param  cal the Calendar
-     * @exception IllegalArgumentException if date is invalid
+     * @throws IllegalArgumentException if date is invalid
      */
     protected static int absoluteDay(Calendar cal, boolean use1904windowing)
     {
@@ -826,7 +826,7 @@ public class DateUtil {
      *
      * @return days number of days since 1900/12/31
      * @param  date the Date
-     * @exception IllegalArgumentException if date is invalid
+     * @throws IllegalArgumentException if date is invalid
      */
     protected static int absoluteDay(LocalDateTime date, boolean use1904windowing)
     {
@@ -839,7 +839,7 @@ public class DateUtil {
      * @return days number of days since 1900/12/31
      * @param  dayOfYear the day of the year
      * @param  year the year
-     * @exception IllegalArgumentException if date is invalid
+     * @throws IllegalArgumentException if date is invalid
      */
     private static int absoluteDay(int year, int dayOfYear, boolean use1904windowing) {
         return dayOfYear + daysInPriorYears(year, use1904windowing);
@@ -851,7 +851,7 @@ public class DateUtil {
      * @return    days  number of days in years prior to yr.
      * @param     yr    a year (1900 < yr < 4000)
      * @param use1904windowing Should 1900 or 1904 date windowing be used?
-     * @exception IllegalArgumentException if year is outside of range.
+     * @throws IllegalArgumentException if year is outside of range.
      */
 
     static int daysInPriorYears(int yr, boolean use1904windowing)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Workbook.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Workbook.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Workbook.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/ss/usermodel/Workbook.java Sat Dec 18 17:41:36 2021
@@ -319,7 +319,7 @@ public interface Workbook extends Closea
      * Write out this workbook to an OutputStream.
      *
      * @param stream - the java OutputStream you wish to write to
-     * @exception IOException if anything can't be written.
+     * @throws IOException if anything can't be written.
      */
     void write(OutputStream stream) throws IOException;
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/ByteField.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/ByteField.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/ByteField.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/ByteField.java Sat Dec 18 17:41:36 2021
@@ -42,7 +42,7 @@ public class ByteField
      *
      * @param offset of the field within its byte array
      *
-     * @exception ArrayIndexOutOfBoundsException if offset is negative
+     * @throws ArrayIndexOutOfBoundsException if offset is negative
      */
 
     public ByteField(final int offset)
@@ -58,7 +58,7 @@ public class ByteField
      * @param offset of the field within its byte array
      * @param value the initial value
      *
-     * @exception ArrayIndexOutOfBoundsException if offset is negative
+     * @throws ArrayIndexOutOfBoundsException if offset is negative
      */
 
     public ByteField(final int offset, final byte value)
@@ -80,7 +80,7 @@ public class ByteField
      * @param offset of the field within its byte array
      * @param data the byte array to read the value from
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is not
+     * @throws ArrayIndexOutOfBoundsException if the offset is not
      *            within the range of 0..(data.length - 1)
      */
 
@@ -100,7 +100,7 @@ public class ByteField
      * @param value the initial value
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is not
+     * @throws ArrayIndexOutOfBoundsException if the offset is not
      *            within the range of 0..(data.length - 1)
      */
 
@@ -139,7 +139,7 @@ public class ByteField
      * @param value to be set
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of the byte array's range
      */
 
@@ -157,7 +157,7 @@ public class ByteField
      *
      * @param data the byte array from which the value is to be read
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of range of the bte array
      */
 
@@ -173,9 +173,9 @@ public class ByteField
      * @param stream the InputStream from which the value is to be
      *               read
      *
-     * @exception BufferUnderrunException if there is not enough data
+     * @throws BufferUnderrunException if there is not enough data
      *            available from the InputStream
-     * @exception IOException if an IOException is thrown from reading
+     * @throws IOException if an IOException is thrown from reading
      *            the InputStream
      */
 
@@ -197,7 +197,7 @@ public class ByteField
      * @param data the array of bytes to which the value is to be
      *             written
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of the byte array's range
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/CodePageUtil.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/CodePageUtil.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/CodePageUtil.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/CodePageUtil.java Sat Dec 18 17:41:36 2021
@@ -250,7 +250,7 @@ public class CodePageUtil
      * eg "windows-1251", or "cp" followed by the number, e.g. if the codepage 
      * number is 1252 the returned character encoding name will be "cp1252".
      *
-     * @exception UnsupportedEncodingException if the specified codepage is
+     * @throws UnsupportedEncodingException if the specified codepage is
      * less than zero.
      */
     public static String codepageToEncoding(final int codepage)
@@ -271,7 +271,7 @@ public class CodePageUtil
      *  
      * @see <a href="http://docs.oracle.com/javase/6/docs/technotes/guides/intl/encoding.doc.html">Supported Encodings</a>
      *
-     * @exception UnsupportedEncodingException if the specified codepage is
+     * @throws UnsupportedEncodingException if the specified codepage is
      * less than zero.
      */
     public static String codepageToEncoding(final int codepage, boolean javaLangFormat)

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/FixedField.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/FixedField.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/FixedField.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/FixedField.java Sat Dec 18 17:41:36 2021
@@ -35,7 +35,7 @@ public interface FixedField
      *
      * @param data the byte array from which the value is to be read
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of the array's valid index range
      */
 
@@ -48,9 +48,9 @@ public interface FixedField
      * @param stream the InputStream from which the value is to be
      *               read
      *
-     * @exception BufferUnderrunException if there is not enough data
+     * @throws BufferUnderrunException if there is not enough data
      *            available from the InputStream
-     * @exception IOException if an IOException is thrown from reading
+     * @throws IOException if an IOException is thrown from reading
      *            the InputStream
      */
 
@@ -64,7 +64,7 @@ public interface FixedField
      * @param data the array of bytes to which the value is to be
      *             written
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of the array's valid index range
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/HexDump.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/HexDump.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/HexDump.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/HexDump.java Sat Dec 18 17:41:36 2021
@@ -45,11 +45,11 @@ public final class HexDump {
      * @param index initial index into the byte array
      * @param length number of characters to output
      *
-     * @exception IOException is thrown if anything goes wrong writing
+     * @throws IOException is thrown if anything goes wrong writing
      *            the data to stream
-     * @exception ArrayIndexOutOfBoundsException if the index is
+     * @throws ArrayIndexOutOfBoundsException if the index is
      *            outside the data array's bounds
-     * @exception IllegalArgumentException if the output stream is
+     * @throws IllegalArgumentException if the output stream is
      *            null
      */
     public static void dump(final byte [] data, final long offset,
@@ -73,11 +73,11 @@ public final class HexDump {
      *               written
      * @param index initial index into the byte array
      *
-     * @exception IOException is thrown if anything goes wrong writing
+     * @throws IOException is thrown if anything goes wrong writing
      *            the data to stream
-     * @exception ArrayIndexOutOfBoundsException if the index is
+     * @throws ArrayIndexOutOfBoundsException if the index is
      *            outside the data array's bounds
-     * @exception IllegalArgumentException if the output stream is
+     * @throws IllegalArgumentException if the output stream is
      *            null
      */
 
@@ -94,7 +94,7 @@ public final class HexDump {
      * @param offset its offset, whatever that might mean
      * @param index initial index into the byte array
      *
-     * @exception ArrayIndexOutOfBoundsException if the index is
+     * @throws ArrayIndexOutOfBoundsException if the index is
      *            outside the data array's bounds
      * @return output string
      */
@@ -111,7 +111,7 @@ public final class HexDump {
      * @param index initial index into the byte array
      * @param length number of characters to output
      *
-     * @exception ArrayIndexOutOfBoundsException if the index is
+     * @throws ArrayIndexOutOfBoundsException if the index is
      *            outside the data array's bounds
      * @return output string
      */

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/IntList.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/IntList.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/IntList.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/IntList.java Sat Dec 18 17:41:36 2021
@@ -82,7 +82,7 @@ public class IntList
      * @param index the index where the new value is to be added
      * @param value the new value
      *
-     * @exception IndexOutOfBoundsException if the index is out of
+     * @throws IndexOutOfBoundsException if the index is out of
      *            range (index &lt; 0 || index &gt; size()).
      */
 
@@ -176,7 +176,7 @@ public class IntList
      *
      * @return true if this list changed as a result of the call.
      *
-     * @exception IndexOutOfBoundsException if the index is out of
+     * @throws IndexOutOfBoundsException if the index is out of
      *            range (index &lt; 0 || index &gt; size())
      */
 
@@ -309,7 +309,7 @@ public class IntList
      *
      * @return the element at the specified position in this list.
      *
-     * @exception IndexOutOfBoundsException if the index is out of
+     * @throws IndexOutOfBoundsException if the index is out of
      *            range (index &lt; 0 || index &gt;= size()).
      */
 
@@ -422,7 +422,7 @@ public class IntList
      *
      * @return the element previously at the specified position.
      *
-     * @exception IndexOutOfBoundsException if the index is out of
+     * @throws IndexOutOfBoundsException if the index is out of
      *            range (index &lt; 0 || index &gt;= size()).
      */
 
@@ -531,7 +531,7 @@ public class IntList
      *
      * @return the element previously at the specified position.
      *
-     * @exception IndexOutOfBoundsException if the index is out of
+     * @throws IndexOutOfBoundsException if the index is out of
      *            range (index &lt; 0 || index &gt;= size()).
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/IntegerField.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/IntegerField.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/IntegerField.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/IntegerField.java Sat Dec 18 17:41:36 2021
@@ -40,7 +40,7 @@ public class IntegerField
      *
      * @param offset of the field within its byte array
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is
+     * @throws ArrayIndexOutOfBoundsException if the offset is
      *            negative
      */
 
@@ -61,7 +61,7 @@ public class IntegerField
      * @param offset of the field within its byte array
      * @param value the initial value
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is
+     * @throws ArrayIndexOutOfBoundsException if the offset is
      *            negative
      */
 
@@ -79,7 +79,7 @@ public class IntegerField
      * @param offset of the field within its byte array
      * @param data the byte array to read the value from
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is not
+     * @throws ArrayIndexOutOfBoundsException if the offset is not
      *            within the range of 0..(data.length - 1)
      */
 
@@ -99,7 +99,7 @@ public class IntegerField
      * @param value the initial value
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is
+     * @throws ArrayIndexOutOfBoundsException if the offset is
      *            negative or too large
      */
 
@@ -139,7 +139,7 @@ public class IntegerField
      * @param value to be set
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is too
+     * @throws ArrayIndexOutOfBoundsException if the offset is too
      *            large
      */
 
@@ -157,7 +157,7 @@ public class IntegerField
      *
      * @param data the byte array from which the value is to be read
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is too
+     * @throws ArrayIndexOutOfBoundsException if the offset is too
      *            large
      */
 
@@ -173,9 +173,9 @@ public class IntegerField
      * @param stream the InputStream from which the value is to be
      *               read
      *
-     * @exception BufferUnderrunException if there is not enough data
+     * @throws BufferUnderrunException if there is not enough data
      *            available from the InputStream
-     * @exception IOException if an IOException is thrown from reading
+     * @throws IOException if an IOException is thrown from reading
      *            the InputStream
      */
 
@@ -192,7 +192,7 @@ public class IntegerField
      * @param data the array of bytes to which the value is to be
      *             written
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is too
+     * @throws ArrayIndexOutOfBoundsException if the offset is too
      *            large
      */
 

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndian.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndian.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndian.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndian.java Sat Dec 18 17:41:36 2021
@@ -491,7 +491,7 @@ public final class LittleEndian implemen
      * @param value
      *            the short (16-bit) value
      *
-     * @exception ArrayIndexOutOfBoundsException
+     * @throws ArrayIndexOutOfBoundsException
      *                may be thrown
      */
     public static void putUByte( byte[] data, int offset, short value ) {
@@ -508,7 +508,7 @@ public final class LittleEndian implemen
      * @param value
      *            the int (32-bit) value
      *
-     * @exception ArrayIndexOutOfBoundsException
+     * @throws ArrayIndexOutOfBoundsException
      *                may be thrown
      */
     public static void putUInt( byte[] data, int offset, long value ) {
@@ -546,7 +546,7 @@ public final class LittleEndian implemen
      * @param value
      *            the short (16-bit) value
      *
-     * @exception ArrayIndexOutOfBoundsException
+     * @throws ArrayIndexOutOfBoundsException
      *                may be thrown
      */
     public static void putUShort( byte[] data, int offset, int value ) {
@@ -576,9 +576,9 @@ public final class LittleEndian implemen
      * @param stream
      *            the InputStream from which the int is to be read
      * @return the int (32-bit) value
-     * @exception IOException
+     * @throws IOException
      *                will be propagated back to the caller
-     * @exception BufferUnderrunException
+     * @throws BufferUnderrunException
      *                if the stream cannot provide enough bytes
      */
     public static int readInt( InputStream stream ) throws IOException {
@@ -599,9 +599,9 @@ public final class LittleEndian implemen
      * @param stream
      *            the InputStream from which the int is to be read
      * @return the unsigned int (32-bit) value
-     * @exception IOException
+     * @throws IOException
      *                will be propagated back to the caller
-     * @exception BufferUnderrunException
+     * @throws BufferUnderrunException
      *                if the stream cannot provide enough bytes
      */
     public static long readUInt( InputStream stream ) throws IOException {
@@ -615,9 +615,9 @@ public final class LittleEndian implemen
      * @param stream
      *            the InputStream from which the long is to be read
      * @return the long (64-bit) value
-     * @exception IOException
+     * @throws IOException
      *                will be propagated back to the caller
-     * @exception BufferUnderrunException
+     * @throws BufferUnderrunException
      *                if the stream cannot provide enough bytes
      */
     public static long readLong( InputStream stream ) throws IOException {
@@ -646,9 +646,9 @@ public final class LittleEndian implemen
      * @param stream
      *            the InputStream from which the short is to be read
      * @return the short (16-bit) value
-     * @exception IOException
+     * @throws IOException
      *                will be propagated back to the caller
-     * @exception BufferUnderrunException
+     * @throws BufferUnderrunException
      *                if the stream cannot provide enough bytes
      */
     public static short readShort( InputStream stream ) throws IOException {

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndianInputStream.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndianInputStream.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndianInputStream.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/LittleEndianInputStream.java Sat Dec 18 17:41:36 2021
@@ -97,7 +97,7 @@ public class LittleEndianInputStream ext
      * get an unsigned int value from an InputStream
      * 
      * @return the unsigned int (32-bit) value
-     * @exception RuntimeException
+     * @throws RuntimeException
      *                wraps any IOException thrown from reading the stream.
      */
     //@Override

Modified: poi/trunk/poi/src/main/java/org/apache/poi/util/LongField.java
URL: http://svn.apache.org/viewvc/poi/trunk/poi/src/main/java/org/apache/poi/util/LongField.java?rev=1896139&r1=1896138&r2=1896139&view=diff
==============================================================================
--- poi/trunk/poi/src/main/java/org/apache/poi/util/LongField.java (original)
+++ poi/trunk/poi/src/main/java/org/apache/poi/util/LongField.java Sat Dec 18 17:41:36 2021
@@ -40,7 +40,7 @@ public class LongField
      *
      * @param offset of the field within its byte array
      *
-     * @exception ArrayIndexOutOfBoundsException if offset is negative
+     * @throws ArrayIndexOutOfBoundsException if offset is negative
      */
 
     public LongField(final int offset)
@@ -61,7 +61,7 @@ public class LongField
      * @param offset of the field within its byte array
      * @param value the initial value
      *
-     * @exception ArrayIndexOutOfBoundsException if offset is negative
+     * @throws ArrayIndexOutOfBoundsException if offset is negative
      */
 
     public LongField(final int offset, final long value)
@@ -78,7 +78,7 @@ public class LongField
      * @param offset of the field within its byte array
      * @param data the byte array to read the value from
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is not
+     * @throws ArrayIndexOutOfBoundsException if the offset is not
      *            within the range of 0..(data.length - 1)
      */
 
@@ -98,7 +98,7 @@ public class LongField
      * @param value the initial value
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if offset is negative
+     * @throws ArrayIndexOutOfBoundsException if offset is negative
      */
 
     public LongField(final int offset, final long value, final byte [] data)
@@ -136,7 +136,7 @@ public class LongField
      * @param value to be set
      * @param data the byte array to write the value to
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of range
      */
 
@@ -154,7 +154,7 @@ public class LongField
      *
      * @param data the byte array from which the value is to be read
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of range
      */
 
@@ -170,9 +170,9 @@ public class LongField
      * @param stream the InputStream from which the value is to be
      *               read
      *
-     * @exception BufferUnderrunException if there is not enough data
+     * @throws BufferUnderrunException if there is not enough data
      *            available from the InputStream
-     * @exception IOException if an IOException is thrown from reading
+     * @throws IOException if an IOException is thrown from reading
      *            the InputStream
      */
 
@@ -189,7 +189,7 @@ public class LongField
      * @param data the array of bytes to which the value is to be
      *             written
      *
-     * @exception ArrayIndexOutOfBoundsException if the offset is out
+     * @throws ArrayIndexOutOfBoundsException if the offset is out
      *            of range
      */
 



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org