diff --git a/src/java/org/apache/poi/POIDocument.java b/src/java/org/apache/poi/POIDocument.java
index 5b1c2da9b..a1a8fe1c8 100644
--- 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 6a038d65a..f3799ab24 100644
--- 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() {