]> source.dussan.org Git - poi.git/commitdiff
cleaned javadocs warnings
authorYegor Kozlov <yegor@apache.org>
Mon, 6 Jun 2011 08:45:06 +0000 (08:45 +0000)
committerYegor Kozlov <yegor@apache.org>
Mon, 6 Jun 2011 08:45:06 +0000 (08:45 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1132549 13f79535-47bb-0310-9956-ffa450edef68

13 files changed:
src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
src/java/org/apache/poi/poifs/filesystem/DirectoryNode.java
src/java/org/apache/poi/poifs/property/PropertyTableBase.java
src/java/org/apache/poi/ss/formula/functions/Irr.java
src/ooxml/java/org/apache/poi/openxml4j/opc/OPCPackage.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFSettings.java
src/scratchpad/src/org/apache/poi/hsmf/MAPIMessage.java
src/scratchpad/src/org/apache/poi/hwpf/HWPFDocument.java
src/scratchpad/src/org/apache/poi/hwpf/HWPFDocumentCore.java

index b7101940cfcfef7a315688401a1b8de7bd5266d2..a0007fcee7b76dd4bdd64bdab8669a65fbb65930 100644 (file)
@@ -266,7 +266,6 @@ public final class HSSFWorkbook extends POIDocument implements org.apache.poi.ss
      *  low level models.  If you're reading in a workbook...start here.
      *
      * @param directory the POI filesystem directory to process from
-     * @param fs the POI filesystem that contains the Workbook stream.
      * @param preserveNodes whether to preseve other nodes, such as
      *        macros.  This takes more memory, so only say yes if you
      *        need to. If set, will store all of the POIFSFileSystem
index d5c75ea17c09dfee65155d2689db81f6c8c7a67e..d6f86d5ef4ecf37a93b6f3dbd2d0c1a26e75a694 100644 (file)
@@ -180,7 +180,7 @@ public class DirectoryNode
     /**
      * open a document in the directory's entry's list of entries
      *
-     * @param documentEntry the document to be opened
+     * @param document the document to be opened
      *
      * @return a newly opened DocumentInputStream or NDocumentInputStream
      *
index a3520815e3111eb76071dec8980f816ea22e6f07..b3690c5c2463be5344c6df504e0b38c61c53951d 100644 (file)
@@ -48,8 +48,8 @@ public abstract class PropertyTableBase implements BATManaged {
      * to extract the property table from it). Populates the
      * properties thoroughly
      *
-     * @param startBlock the first block of the property table
-     * @param blockList the list of blocks
+     * @param header_block the first block to read from
+     * @param properties the list to populate
      *
      * @exception IOException if anything goes wrong (which should be
      *            a result of the input being NFG)
index 27f7232eb25972ae19000cd0d4cb65ccdb92505f..a2faf181ca08f318b65cd7cad86745ed01fe32ed 100644 (file)
@@ -75,7 +75,7 @@ public final class Irr implements Function {
      * </p>
      * <p>
      *   The implementation is inspired by the NewtonSolver from the Apache Commons-Math library,
-     *   @see {http://commons.apache.org/}
+     *   @see <a href="http://commons.apache.org">http://commons.apache.org</a>
      * </p>
      *
      * @param values        the income values.
@@ -83,8 +83,10 @@ public final class Irr implements Function {
      * @return the irr value. The method returns <code>Double.NaN</code>
      *  if the maximum iteration count is exceeded
      *
-     * @see {http://en.wikipedia.org/wiki/Internal_rate_of_return#Numerical_solution}
-     * @see {http://en.wikipedia.org/wiki/Newton%27s_method}
+     * @see <a href="http://en.wikipedia.org/wiki/Internal_rate_of_return#Numerical_solution">
+     *     http://en.wikipedia.org/wiki/Internal_rate_of_return#Numerical_solution</a>
+     * @see <a href="http://en.wikipedia.org/wiki/Newton%27s_method">
+     *     http://en.wikipedia.org/wiki/Newton%27s_method</a>
      */
     public static double irr(double[] values, double guess) {
         int maxIterationCount = 20;
index a9b08eec3aa8ad3ec4ce68063b84484ae8c77e7f..6ec685cb4e43be1b8fb7f28ec213bac100581461 100644 (file)
@@ -556,9 +556,6 @@ public abstract class OPCPackage implements RelationshipSource, Closeable {
                return retArr;
        }
 
-       /**
-        * @return
-        */
        public List<PackagePart> getPartsByName(final Pattern namePattern) {
            if (namePattern == null) {
                throw new IllegalArgumentException("name pattern must not be null");
index 517c72358e6d0958add8ebf2908462653c713c18..c21822d58759d5f3c2503872c11f69c85308e2f9 100644 (file)
@@ -495,7 +495,7 @@ public class XWPFDocument extends POIXMLDocument implements Document, IBody {
     }
 
     /**
-     * add a new paragraph at position of the cursor. The cursor must be on the
+     * Add a new paragraph at position of the cursor. The cursor must be on the
      * {@link TokenType#START} tag of an subelement of the documents body. When
      * this method is done, the cursor passed as parameter points to the
      * {@link TokenType#END} of the newly inserted paragraph.
index 482994b1281e7edab18f1b795b86a67343a95525..59b667f3bb51d97da7f9776441caa7e597cd086c 100644 (file)
@@ -226,7 +226,7 @@ public abstract class XWPFHeaderFooter extends POIXMLDocumentPart implements IBo
     /**
      * Adds a picture to the document.
      *
-     * @param is                The stream to read image from
+     * @param pictureData       The picture data
      * @param format            The format of the picture.
      *
      * @return the index to this picture (0 based), the added picture can be obtained from {@link #getAllPictures()} .
index 861b07409b8c3909ca2ef2316329b5177f6ad5fa..2b4ca7049aa1da15ddd9cd6eb5f5857414cdcbe8 100644 (file)
@@ -166,7 +166,7 @@ public class XWPFNumbering extends POIXMLDocumentPart {
        
        /**
         * Add a new num with an abstractNumID and a numID
-        * @param abstractNumId
+        * @param abstractNumID
         * @param numID
         */
        public void addNum(BigInteger abstractNumID, BigInteger numID){
index 8c5582bc82403bba35a16288960c7927ae1727a9..5190f22840925087208f071e2035402a84591757 100644 (file)
@@ -1270,7 +1270,6 @@ public class XWPFParagraph implements IBodyElement {
      * adds a new Run to the Paragraph
      * 
      * @param r
-     * @return
      */
     public void addRun(XWPFRun r) {
         if (!runs.contains(r)) {
@@ -1282,7 +1281,6 @@ public class XWPFParagraph implements IBodyElement {
      * return the XWPFRun-Element which owns the CTR run-Element
      * 
      * @param r
-     * @return
      */
     public XWPFRun getRun(CTR r) {
         for (int i = 0; i < getRuns().size(); i++) {
index 18d787504a02854e7c1c014c25f89ec22a15db7f..84b9fdf66ca7429e48a139a317200a8a7afdde47 100644 (file)
@@ -87,7 +87,6 @@ public class XWPFSettings extends POIXMLDocumentPart {
      * <pre>
      *    &lt;w:zoom w:percent="50" /&gt; 
      * <pre>
-     * @return percentage as an integer of zoom level
      */
     public void setZoomPercent(long zoomPercent) {
        if (! ctSettings.isSetZoom()) {
index 4d00e79e41bc939ad06e8ba43b2d4e661ac5a083..91c4c7479c080ee8308f74d9d985b2b91469b716 100644 (file)
@@ -118,7 +118,6 @@ public class MAPIMessage extends POIDocument {
     * Constructor for reading MSG Files from a certain
     *  point within a POIFS filesystem
     * @param poifsDir
-    * @param fs
     * @throws IOException
     */
    public MAPIMessage(DirectoryNode poifsDir) throws IOException {
index 98fbfbe96d8d0d310a63561599c048e9459f49c9..c5c4d82aa8034c33134784e1fe14b081373887fd 100644 (file)
@@ -152,7 +152,7 @@ public final class HWPFDocument extends HWPFDocumentCore
    *  in a POIFSFileSystem, probably not the default.
    * Used typically to open embeded documents.
    *
-   * @param pfilesystem The POIFSFileSystem that contains the Word document.
+   * @param directory The DirectoryNode that contains the Word document.
    * @throws IOException If there is an unexpected IOException from the passed
    *         in POIFSFileSystem.
    */
index 75eb565f3ac10a787b1e032309044cae703057e8..e37aee1f298a1e1c07a4e2c05e9e40007c762b9e 100644 (file)
@@ -126,7 +126,7 @@ public abstract class HWPFDocumentCore extends POIDocument
    *  in a POIFSFileSystem, probably not the default.
    * Used typically to open embeded documents.
    *
-   * @param pfilesystem The POIFSFileSystem that contains the Word document.
+   * @param directory The DirectoryNode that contains the Word document.
    * @throws IOException If there is an unexpected IOException from the passed
    *         in POIFSFileSystem.
    */