diff --git a/src/ooxml/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java b/src/ooxml/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
index ecfa5cd625..453c1b1e28 100644
--- a/src/ooxml/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
+++ b/src/ooxml/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
@@ -437,13 +437,7 @@ public class XMLSlideShow extends POIXMLDocument implements SlideShow {
      * @param pictureData       The bytes of the picture
      * @param format            The format of the picture.
      *
-     * @return the index to this picture (1 based).
-     * @see XSLFPictureData#PICTURE_TYPE_EMF
-     * @see XSLFPictureData#PICTURE_TYPE_WMF
-     * @see XSLFPictureData#PICTURE_TYPE_PICT
-     * @see XSLFPictureData#PICTURE_TYPE_JPEG
-     * @see XSLFPictureData#PICTURE_TYPE_PNG
-     * @see XSLFPictureData#PICTURE_TYPE_DIB
+     * @return the picture data
      */
     public XSLFPictureData addPicture(byte[] pictureData, PictureType format) {
         XSLFPictureData img = findPictureData(pictureData);
diff --git a/src/scratchpad/src/org/apache/poi/hslf/model/OLEShape.java b/src/scratchpad/src/org/apache/poi/hslf/model/OLEShape.java
index 3e3436eb87..6f8792df26 100644
--- a/src/scratchpad/src/org/apache/poi/hslf/model/OLEShape.java
+++ b/src/scratchpad/src/org/apache/poi/hslf/model/OLEShape.java
@@ -48,7 +48,7 @@ public final class OLEShape extends HSLFPictureShape {
     /**
      * Create a new <code>OLEShape</code>
      *
-     * @param idx the index of the picture
+     * @param data the picture data
      * @param parent the parent shape
      */
     public OLEShape(HSLFPictureData data, ShapeContainer<HSLFShape> parent) {
diff --git a/src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFPictureShape.java b/src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFPictureShape.java
index 807af0d5f1..10e9555c8c 100644
--- a/src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFPictureShape.java
+++ b/src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFPictureShape.java
@@ -54,7 +54,7 @@ public class HSLFPictureShape extends HSLFSimpleShape implements PictureShape {
     /**
      * Create a new <code>Picture</code>
      *
-    * @param idx the index of the picture
+    * @param data the picture data
      */
     public HSLFPictureShape(HSLFPictureData data){
         this(data, null);
@@ -63,7 +63,7 @@ public class HSLFPictureShape extends HSLFSimpleShape implements PictureShape {
     /**
      * Create a new <code>Picture</code>
      *
-     * @param idx the index of the picture
+     * @param data the picture data
      * @param parent the parent shape
      */
     public HSLFPictureShape(HSLFPictureData data, ShapeContainer<HSLFShape> parent) {