fixed javadoc warnings

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

src/java/org/apache/poi/ddf/EscherRecord.java

@@ -297,7 +297,7 @@ public abstract class EscherRecord {
 
     /**
      * @param tab - each children must be a right of his parent
-     * @return
+     * @return xml representation of this record
      */
     public String toXml(String tab){
         StringBuilder builder = new StringBuilder();

src/java/org/apache/poi/hssf/record/DConRefRecord.java

@@ -278,7 +278,7 @@ public class DConRefRecord extends StandardRecord
 
     /**
      * @return the link's path, with the special characters stripped/replaced. May be null.
-     * @see MS-XLS 2.5.277 (VirtualPath)
+     * See MS-XLS 2.5.277 (VirtualPath)
      */
     public String getReadablePath()
     {

src/java/org/apache/poi/hssf/usermodel/HSSFClientAnchor.java

@@ -180,7 +180,7 @@ public final class HSSFClientAnchor extends HSSFAnchor implements ClientAnchor {
     }
 
     /**
-     * @return the row(0 based) of the second cell.
+     * @param row2 the row(0 based) of the second cell.
      */
     public void setRow2(int row2) {
         checkRange(row2, 0, 256 * 256, "row2");

src/java/org/apache/poi/hssf/usermodel/HSSFCombobox.java

@@ -22,7 +22,6 @@ import org.apache.poi.hssf.record.*;
 
 /**
  * @author Evgeniy Berlog
- * @date 12.07.12
  */
 public class HSSFCombobox extends HSSFSimpleShape {
 

src/java/org/apache/poi/ss/formula/WorkbookEvaluator.java

@@ -719,7 +719,7 @@ public final class WorkbookEvaluator {
      * </ul>
      *
      * @param ignore whether to ignore missing references to external workbooks
-     * @see <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=52575">Bug 52575</a> for details
+     * @see <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=52575">Bug 52575 for details</a>
      */
     public void setIgnoreMissingWorkbooks(boolean ignore){
         _ignoreMissingWorkbooks = ignore;

src/java/org/apache/poi/ss/usermodel/DateUtil.java

@@ -256,7 +256,7 @@ public class DateUtil {
 
     /**
      * Get EXCEL date as Java Calendar with given time zone.
-     * @see getJavaDate(double, TimeZone)
+     * @see #getJavaDate(double, TimeZone)
      * @return Java representation of the date, or null if date is not a valid Excel date
      */
     public static Calendar getJavaCalendar(double date, boolean use1904windowing, TimeZone timeZone) {

src/ooxml/java/org/apache/poi/xslf/usermodel/XSLFShapeContainer.java

@@ -52,9 +52,6 @@ public interface XSLFShapeContainer extends Iterable<XSLFShape> {
 
     /**
      * create a picture belonging to this container
-     *
-     * @param pictureIndex
-     * @return
      */
     XSLFPictureShape createPicture(int pictureIndex);
 

src/ooxml/java/org/apache/poi/xslf/usermodel/XSLFTextParagraph.java

@@ -302,8 +302,6 @@ public class XSLFTextParagraph implements Iterable<XSLFTextRun>{
      * If bulletSize >= 0, then bulletSize is a percentage of the font size.
      * If bulletSize < 0, then it specifies the size in points
      * </p>
-     *
-     * @return the bullet size
      */
     public void setBulletFontSize(double bulletSize){
         CTTextParagraphProperties pr = _p.isSetPPr() ? _p.getPPr() : _p.addNewPPr();

src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFRun.java

@@ -655,8 +655,8 @@ public class XWPFRun {
      *  
      * @param pictureData The raw picture data
      * @param pictureType The type of the picture, eg {@link Document#PICTURE_TYPE_JPEG}
-     * @param image width in EMUs. To convert to / from points use {@link org.apache.poi.util.Units}
-     * @param image height in EMUs. To convert to / from points use {@link org.apache.poi.util.Units}
+     * @param width width in EMUs. To convert to / from points use {@link org.apache.poi.util.Units}
+     * @param height height in EMUs. To convert to / from points use {@link org.apache.poi.util.Units}
      * @throws org.apache.poi.openxml4j.exceptions.InvalidFormatException
      * @throws IOException
      */

src/scratchpad/src/org/apache/poi/hslf/model/textproperties/TextPFException9.java

@@ -28,7 +28,8 @@ import org.apache.poi.util.LittleEndian;
  * This structure store text autonumber scheme and start number.
  * If a paragraph has an autonumber(fBulletHasAutoNumber = 0x0001) but start number and scheme are empty,
  * this means the default values will be used: statNumber=1 and sheme=ANM_ArabicPeriod
- * @see http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28
+ * @see <a href="http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28">
+ *     http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28</a>
  *
  * @author Alex Nikiforov [mailto:anikif@gmail.com]
  *