Fix JavaDoc warnings

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

diff --git a/src/java/org/apache/poi/POIDocument.java b/src/java/org/apache/poi/POIDocument.java
index 5b1c2da9b5be51efb5d6104eb967ac4e472ed99a..a1a8fe1c8054909fe387f72fb509d12779afe527 100644 (file)
--- a/src/java/org/apache/poi/POIDocument.java
+++ b/src/java/org/apache/poi/POIDocument.java
@@ -236,7 +236,7 @@ public abstract class POIDocument {
      * @param source is the source POIFS to copy from
      * @param target is the target POIFS to copy to
      * @param excepts is a list of Strings specifying what nodes NOT to copy
-     * @deprecated Use {@link EntryUtils#copyNodes(DirectoryEntry, DirectoryEntry, List<String>)} instead
+     * @deprecated Use {@link EntryUtils#copyNodes(DirectoryEntry, DirectoryEntry, List)} instead
      */
     @Deprecated
     protected void copyNodes( POIFSFileSystem source, POIFSFileSystem target,
@@ -249,7 +249,7 @@ public abstract class POIDocument {
     * @param sourceRoot is the source POIFS to copy from
     * @param targetRoot is the target POIFS to copy to
     * @param excepts is a list of Strings specifying what nodes NOT to copy
-    * @deprecated Use {@link EntryUtils#copyNodes(DirectoryEntry, DirectoryEntry, List<String>)} instead
+    * @deprecated Use {@link EntryUtils#copyNodes(DirectoryEntry, DirectoryEntry, List)} instead
     */
     @Deprecated
     protected void copyNodes( DirectoryNode sourceRoot,

diff --git a/src/ooxml/java/org/apache/poi/xssf/model/CommentsTable.java b/src/ooxml/java/org/apache/poi/xssf/model/CommentsTable.java
index 6a038d65acf3be1335e8ea62596e50d01d8c63b7..f3799ab24e1e69636547de948764e728f574062a 100644 (file)
--- a/src/ooxml/java/org/apache/poi/xssf/model/CommentsTable.java
+++ b/src/ooxml/java/org/apache/poi/xssf/model/CommentsTable.java
@@ -128,9 +128,8 @@ public class CommentsTable extends POIXMLDocumentPart {
 
     /**
      * This method is deprecated and should not be used any more as
-     * it overwrites the comment in Cell A1.
-     *
-     * @return
+     * it silently overwrites the comment in Cell A1 if present
+     * @deprecated Use {@link #newComment(String)} instead to explicitly set the cell reference to create for
      */
     @Deprecated
     public CTComment newComment() {