try to javadoc more unsupported methods

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1914791 13f79535-47bb-0310-9956-ffa450edef68
apache · Dec 20, 2023 · 7e5e9fc · 7e5e9fc
1 parent c732418
commit 7e5e9fc
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 1 deletion.
diff --git a/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontFacet.java b/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontFacet.java
@@ -45,6 +45,7 @@ default int getWeight() {
      * Set the font weight
      *
      * @param weight the font weight
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontFacet is read-only
      */
     default void setWeight(int weight) {
         throw new UnsupportedOperationException("FontFacet is read-only.");
@@ -61,6 +62,7 @@ default boolean isItalic() {
      * Set the font posture
      *
      * @param italic {@code true} for italic, {@code false} for regular
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontFacet is read-only
      */
     default void setItalic(boolean italic) {
         throw new UnsupportedOperationException("FontFacet is read-only.");

diff --git a/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java b/poi/src/main/java/org/apache/poi/common/usermodel/fonts/FontInfo.java
@@ -69,6 +69,7 @@ default void setIndex(int index) {
      *
      * @param typeface the full name of the font, when {@code null} removes the font definition -
      *    removal is implementation specific
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontInfo is read-only
      */
     default void setTypeface(String typeface) {
         throw new UnsupportedOperationException("FontInfo is read-only.");
@@ -85,6 +86,7 @@ default FontCharset getCharset() {
      * Sets the charset
      *
      * @param charset the charset
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontInfo is read-only
      */
     default void setCharset(FontCharset charset) {
         throw new UnsupportedOperationException("FontInfo is read-only.");
@@ -101,6 +103,7 @@ default FontFamily getFamily() {
      * Sets the font family class
      *
      * @param family the font family class
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontInfo is read-only
      */
     default void setFamily(FontFamily family) {
         throw new UnsupportedOperationException("FontInfo is read-only.");
@@ -134,6 +137,7 @@ default byte[] getPanose() {
     /**
      * Set the panose in binary form
      * @param panose the panose bytes
+     * @throws UnsupportedOperationException can return UnsupportedOperationException when FontInfo is read-only
      */
     default void setPanose(byte[] panose) {
         throw new UnsupportedOperationException("FontInfo is read-only.");

diff --git a/poi/src/main/java/org/apache/poi/ss/usermodel/DataFormatter.java b/poi/src/main/java/org/apache/poi/ss/usermodel/DataFormatter.java
@@ -814,7 +814,7 @@ private Object scaleInput(Object obj) {
                 } else if (obj instanceof Double) {
                     obj = (Double) obj / divider.doubleValue();
                 } else {
-                    throw new UnsupportedOperationException();
+                    throw new UnsupportedOperationException("cannot scaleInput of type " + obj.getClass());
                 }
             }
             return obj;