]> source.dussan.org Git - poi.git/commitdiff
cleaned javadoc warnings
authorYegor Kozlov <yegor@apache.org>
Sun, 6 Jun 2010 18:19:08 +0000 (18:19 +0000)
committerYegor Kozlov <yegor@apache.org>
Sun, 6 Jun 2010 18:19:08 +0000 (18:19 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@951920 13f79535-47bb-0310-9956-ffa450edef68

23 files changed:
src/java/org/apache/poi/hssf/eventusermodel/HSSFEventFactory.java
src/java/org/apache/poi/hssf/eventusermodel/HSSFRequest.java
src/java/org/apache/poi/hssf/record/NameRecord.java
src/java/org/apache/poi/hssf/record/RecordInputStream.java
src/java/org/apache/poi/hssf/record/aggregates/SharedValueManager.java
src/java/org/apache/poi/hssf/record/common/FeatFormulaErr2.java
src/java/org/apache/poi/hssf/record/common/FeatProtection.java
src/java/org/apache/poi/hssf/record/common/FeatSmartTag.java
src/java/org/apache/poi/hssf/record/formula/functions/TextFunction.java
src/java/org/apache/poi/hssf/usermodel/HSSFDataFormat.java
src/java/org/apache/poi/poifs/storage/RawDataBlock.java
src/java/org/apache/poi/ss/format/CellFormatter.java
src/java/org/apache/poi/ss/formula/TwoDEval.java
src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java
src/java/org/apache/poi/ss/usermodel/BuiltinFormats.java
src/ooxml/java/org/apache/poi/xssf/model/MapInfo.java
src/ooxml/java/org/apache/poi/xssf/model/Table.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
src/scratchpad/src/org/apache/poi/hsmf/MAPIMessage.java
src/scratchpad/src/org/apache/poi/hsmf/datatypes/ByteChunk.java
src/scratchpad/src/org/apache/poi/hsmf/datatypes/MessageSubmissionChunk.java
src/testcases/org/apache/poi/hssf/record/formula/functions/TestCountFuncs.java
src/testcases/org/apache/poi/hssf/record/formula/functions/TestFind.java

index ede5612cba1d5aacd5f3e3a861083369d9e95a80..3b064dc533a2caa2ee253ff06e38f99b92f144e3 100644 (file)
@@ -34,8 +34,6 @@ import org.apache.poi.poifs.filesystem.POIFSFileSystem;
  * a static id matching one that you have registered in your HSSFRequest will be passed
  * to your associated HSSFListener.
  *
- * @see org.apache.poi.hssf.dev.EFHSSF
- *
  * @author Andrew C. Oliver (acoliver at apache dot org)
  * @author Carey Sublette  (careysub@earthling.net)
  */
@@ -59,7 +57,7 @@ public class HSSFEventFactory {
     * Processes a file into essentially record events.
     *
     * @param req an Instance of HSSFRequest which has your registered listeners
-    * @param fs  a POIFS filesystem containing your workbook
+    * @param dir  a DirectoryNode containing your workbook
     */
    public void processWorkbookEvents(HSSFRequest req, DirectoryNode dir) throws IOException {
       InputStream in = dir.createDocumentInputStream("Workbook");
@@ -83,7 +81,7 @@ public class HSSFEventFactory {
         * Processes a file into essentially record events.
         *
         * @param req an Instance of HSSFRequest which has your registered listeners
-        * @param fs  a POIFS filesystem containing your workbook
+        * @param dir  a DirectoryNode containing your workbook
         * @return    numeric user-specified result code.
         */
        public short abortableProcessWorkbookEvents(HSSFRequest req, DirectoryNode dir)
index af23a2c495f4976938fc01d10b72ea19f0f68245..dd30d4ddb68bc1f0534b15ac6b77a0348f5fdf60 100644 (file)
@@ -31,7 +31,6 @@ import org.apache.poi.hssf.record.RecordFactory;
  *
  * @see org.apache.poi.hssf.eventusermodel.HSSFEventFactory
  * @see org.apache.poi.hssf.eventusermodel.HSSFListener
- * @see org.apache.poi.hssf.dev.EFHSSF
  * @see org.apache.poi.hssf.eventusermodel.HSSFUserException
  * @author  Andrew C. Oliver (acoliver at apache dot org)
  * @author Carey Sublette (careysub@earthling.net)
index 9084f123698138fa40cdb0d0af8cd202649c5a67..144a15e02db55cb165e11b20f8f9c3cd2fe16ef8 100644 (file)
@@ -242,7 +242,7 @@ public final class NameRecord extends StandardRecord {
         * Indicates that the defined name refers to a user-defined function.
         * This attribute is used when there is an add-in or other code project associated with the file.
         *
-        * @param value <code>true</code> indicates the name refers to a function.
+        * @param function <code>true</code> indicates the name refers to a function.
         */
        public void setFunction(boolean function){
                if (function) {
index c044dd7796302688d6da56339cca6b07e467aaa1..6a49ad2830823dfd4c739b09f2c8a6bb5c024927 100644 (file)
@@ -431,7 +431,7 @@ public final class RecordInputStream implements LittleEndianInput {
        }
 
     /**
-     @requrn sid of next record. Can be called after hasNextRecord()  
+     @return sid of next record. Can be called after hasNextRecord()
      */
     public int getNextSid() {
         return _nextSid;
index 91c3e3b15c54cbcef3e037978ffb7992d5fb4305..ff29dd1aba97649e7856cb40fb59ae819dad57a8 100644 (file)
@@ -154,12 +154,6 @@ public final class SharedValueManager {
        }
 
        /**
-        * @param firstCells
-        * @param recs list of sheet records (possibly contains records for other parts of the Excel file)
-        * @param startIx index of first row/cell record for current sheet
-        * @param endIx one past index of last row/cell record for current sheet.  It is important
-        * that this code does not inadvertently collect <tt>SharedFormulaRecord</tt>s from any other
-        * sheet (which could happen if endIx is chosen poorly).  (see bug 44449)
         */
        public static SharedValueManager create(SharedFormulaRecord[] sharedFormulaRecords,
                        CellReference[] firstCells, ArrayRecord[] arrayRecords, TableRecord[] tableRecords) {
index adf1b888abfe182864e6c101d0111be35264158a..b3a9a96ad4e8ddafda02dfa6d4b02321699e2357 100644 (file)
@@ -30,8 +30,7 @@ import org.apache.poi.util.LittleEndianOutput;
  * <P>
  * This record part specifies Formula Evaluation & Error Ignoring data 
  *  for a sheet, stored as part of a Shared Feature. It can be found in 
- *  records such as {@link FeatRecord}, {@link Feat11Record} or
- *  {@link Feat12Record}.
+ *  records such as {@link FeatRecord}.
  * For the full meanings of the flags, see pages 669 and 670
  *  of the Excel binary file format documentation.
  */
index bab65e621805ba3b45feee14407762cbdcc795c9..a10d7119c08196ca75f38cb453db84c7d7701463 100644 (file)
@@ -31,8 +31,7 @@ import org.apache.poi.util.StringUtil;
  * <P>
  * This record part specifies Protection data for a sheet, stored
  *  as part of a Shared Feature. It can be found in records such
- *  as {@link FeatRecord}, {@link Feat11Record} or
- *  {@link Feat12Record}  
+ *  as {@link FeatRecord}
  */
 public final class FeatProtection implements SharedFeature {
        public static long NO_SELF_RELATIVE_SECURITY_FEATURE = 0;
index 2fc53e24f431f7ab1d8041b9c01ed637b443432c..f2e9cc69f7315dab53354ef92e471a286f5e5b66 100644 (file)
@@ -27,8 +27,7 @@ import org.apache.poi.util.LittleEndianOutput;
  * Title: FeatSmartTag (Smart Tag Shared Feature) common record part
  * <P>
  * This record part specifies Smart Tag data for a sheet, stored as part
- *  of a Shared Feature. It can be found in records such as 
- *  {@link FeatRecord}, {@link Feat11Record} or {@link Feat12Record}.
+ *  of a Shared Feature. It can be found in records such as  {@link FeatRecord}.
  * It is made up of a hash, and a set of Factoid Data that makes up
  *  the smart tags.
  * For more details, see page 669 of the Excel binary file
index 3e43ac28f67348d262977df48358221ee67d92dc..6e7e83a8c37cbbb8e5c7e5ff3da7ad9d5b7db8d3 100644 (file)
@@ -353,7 +353,7 @@ public abstract class TextFunction implements Function {
         * <tt>start_num</tt>, is optional (default=1) and specifies where to start searching
         * from.  Character positions are 1-based.<p/>
         *
-        * @author Torstein Tauno Svendsen (torstei@officenet.no)
+        * Author: Torstein Tauno Svendsen (torstei@officenet.no)
         */
        public static final Function FIND = new SearchFind(true);
        /**
index f18f377387fbeea7425ea106de6d4078fa917c64..beb22a2a41d2b763def88e58be678da6291d4647 100644 (file)
@@ -96,7 +96,7 @@ public final class HSSFDataFormat implements DataFormat {
         * Get the format index that matches the given format
         *  string, creating a new format entry if required.
         * Aliases text to the proper format as required.
-        * @param format string matching a built in format
+        * @param pFormat string matching a built in format
         * @return index of format.
         */
        public short getFormat(String pFormat) {
index 07832db260c52990834d4ed93c3f4fcecaa650b0..018ee8ff2e79d46835ded71279272c95f23a7998 100644 (file)
@@ -57,7 +57,8 @@ public class RawDataBlock
      * Constructor RawDataBlock
      *
      * @param stream the InputStream from which the data will be read
-     * @param blockSize the size of the POIFS blocks, normally 512 bytes {@link POIFSConstants#BIG_BLOCK_SIZE}
+     * @param blockSize the size of the POIFS blocks, normally 512 bytes
+     * {@link org.apache.poi.poifs.common.POIFSConstants#SMALLER_BIG_BLOCK_SIZE}
      *
      * @exception IOException on I/O errors, and if an insufficient
      *            amount of data is read (the InputStream must
index a12518120002594f404d1c43cd5ba6a4cf34f543..23cfbe541c3a953d8ae4bf7e1070713905fb40f5 100644 (file)
@@ -22,7 +22,7 @@ import java.util.logging.Logger;
 /**
  * This is the abstract supertype for the various cell formatters.
  *
- * @@author Ken Arnold, Industrious Media LLC
+ * @author Ken Arnold, Industrious Media LLC
  */
 public abstract class CellFormatter {
     /** The original specified format. */
index ff3b933f9649426ac1c652057e784f3d96fb23cc..fbb24e8dded2379dbf9b440efa6989c23739cd7e 100644 (file)
@@ -21,7 +21,7 @@ import org.apache.poi.hssf.record.formula.eval.AreaEval;
 import org.apache.poi.hssf.record.formula.eval.ValueEval;
 
 /**
- * Common interface of {@link AreaEval} and {@link ArrayEval}
+ * Common interface of {@link AreaEval} and {@link org.apache.poi.hssf.record.formula.eval.AreaEvalBase}
  *
  * @author Josh Micich
  */
index 7985603748c542982e2ef02dd8935f97e62799db..258a5166fcbf4cd3f4fa6fb0a57a1534ca4c24b7 100644 (file)
@@ -104,7 +104,9 @@ public final class ForkedEvaluator {
         * evaluateInCell() when the call should not modify the contents of the
         * original cell.
         *
-        * @param cell may be <code>null</code> signifying that the cell is not present (or blank)
+     * @param sheetName the name of the sheet containing the cell
+     * @param rowIndex zero based
+     * @param columnIndex zero based
         * @return <code>null</code> if the supplied cell is <code>null</code> or blank
         */
        public ValueEval evaluate(String sheetName, int rowIndex, int columnIndex) {
index e9eebaff41c5eb09dbae2e7cb6f656f409a9c1be..a63bff36629520516929948b7a68bccee3724ad1 100644 (file)
@@ -172,7 +172,7 @@ public final class BuiltinFormats {
         * <p/>
         * Automatically converts "text" to excel's format string to represent text.
         * </p>
-        * @param fmt string matching a built-in format
+        * @param pFmt string matching a built-in format
         * @return index of format or -1 if undefined.
         */
        public static int getBuiltinFormat(String pFmt) {
index f1243d3e1c51c97cbb51e8454f8e9734e4602077..eb66c7df96db65870baa4de06713d598a69806de 100644 (file)
@@ -100,9 +100,9 @@ public class MapInfo extends POIXMLDocumentPart {
        }
 
        /**
-        * Gets the CTSchema buy it's ID
+        * Gets the
         * @param schemaId the schema ID
-        * @return 
+        * @return CTSchema by it's ID
         */
        public CTSchema getCTSchemaById(String schemaId){
                CTSchema xmlSchema = null;
index 9ab24ac57a2fd8e7aa4c4c0c516cd14bb3837ac5..eddff2296485e35c592bdce8f1024daf1e6c9719 100644 (file)
@@ -187,8 +187,7 @@ public class Table extends POIXMLDocumentPart {
        }
 
        /**
-        *  the number of mapped table columns (see Open Office XML Part 4: chapter 3.5.1.4)
-        * @return 
+        * @return  the number of mapped table columns (see Open Office XML Part 4: chapter 3.5.1.4)
         */
        public long getNumerOfMappedColumns(){
                return ctTable.getTableColumns().getCount();
@@ -196,9 +195,9 @@ public class Table extends POIXMLDocumentPart {
        
        
        /**
-        * The reference for the cell in the top-left part of the table 
+        * @return The reference for the cell in the top-left part of the table
         * (see Open Office XML Part 4: chapter 3.5.1.2, attribute ref) 
-        * @return
+        *
         */
        public CellReference getStartCellReference() {
                
@@ -212,9 +211,9 @@ public class Table extends POIXMLDocumentPart {
        }
        
        /**
-        * The reference for the cell in the bottom-right part of the table
+        * @return The reference for the cell in the bottom-right part of the table
         * (see Open Office XML Part 4: chapter 3.5.1.2, attribute ref)
-        * @return
+        *
         */
        public CellReference getEndCellReference() {
                
@@ -230,8 +229,8 @@ public class Table extends POIXMLDocumentPart {
        
        
        /**
-        * Gets the total number of rows in the selection. (Note: in this version autofiltering is ignored)
-        * @return 
+        *  @return the total number of rows in the selection. (Note: in this version autofiltering is ignored)
+        *
         */
        public int getRowCount(){
                
index b09cc1edd2ebf9decc511dcdfdae6fd3f0cac80a..bf8202dad11014b1e0dd376c44655dbe9daa9b21 100644 (file)
@@ -987,8 +987,7 @@ public class XWPFParagraph {
     }
     
     /**
-     * Gets the style of the paragraph
-     * @return
+     * @return  the style of the paragraph
      */
     public String getStyle() {
        CTPPr pr = getCTPPr();
index 9b2ccd7659fc4893cde138f702a10e3c2281336a..8d84b1627a4ea3c9d08440901530643245e55033 100644 (file)
@@ -85,7 +85,7 @@ public class MAPIMessage extends POIDocument {
    }
    /**
     * Constructor for reading MSG Files from a POIFS filesystem
-    * @param in
+    * @param fs
     * @throws IOException
     */
    public MAPIMessage(POIFSFileSystem fs) throws IOException {
@@ -94,7 +94,8 @@ public class MAPIMessage extends POIDocument {
    /**
     * Constructor for reading MSG Files from a certain
     *  point within a POIFS filesystem
-    * @param in
+    * @param poifsDir
+    * @param fs
     * @throws IOException
     */
    public MAPIMessage(DirectoryNode poifsDir, POIFSFileSystem fs) throws IOException {
index 2f430ed54d2a2ed57ce8a6bc990f44b3bca2e124..fc84d3731b514118d7b71af94a3549478485303d 100644 (file)
@@ -68,7 +68,7 @@ public class ByteChunk extends Chunk {
     * If your data isn't in fact stored as basically
     *  ASCII, don't expect this to return much of any
     *  sense.... 
-    * @return
+    * @return  the data formatted as a string
     */
    public String getAs7bitString() {
       return StringChunk.parseAs7BitData(value);
index 7ca6fee3f6297c37efb221a4968c3ad214aba242..902549c1f0327a9971d42d2c5496f37881d5c9f4 100644 (file)
@@ -103,16 +103,16 @@ public class MessageSubmissionChunk extends Chunk {
    }
    
    /**
-    * Returns the date that the server accepted the
+    * @return the date that the server accepted the
     *  message, as found from the message ID it generated.
-    * @return
+    *
     */
    public Calendar getAcceptedAtTime() {
       return date;
    }
    
    /**
-    * Returns the full ID that the server generated when
+    * @return the full ID that the server generated when
     *  it accepted the message.
     */
    public String getSubmissionId() {
index 08056cd0303133370ab0053def10c895ae95fab9..bb3cfabe1f2c0b054828967e4a1ac82e526624f4 100644 (file)
@@ -236,7 +236,7 @@ public final class TestCountFuncs extends TestCase {
        }
 
        /**
-        * the criteria arg is mostly handled by {@link OperandResolver#getSingleValue(Eval, int, short)}
+        * the criteria arg is mostly handled by {@link OperandResolver#getSingleValue(org.apache.poi.hssf.record.formula.eval.ValueEval, int, int)}}
         */
        public void testCountifAreaCriteria() {
                int srcColIx = 2; // anything but column A
index 3a6df73542f81b525d5798e470792e9362184ef0..8fb3b2ba95727d7f68c689b34c60379bc7adfb8a 100644 (file)
@@ -26,7 +26,7 @@ import org.apache.poi.hssf.usermodel.HSSFWorkbook;
 import org.apache.poi.ss.usermodel.CellValue;
 
 /**
- * Tests for {@link Find}
+ * Tests for {@link Financed}
  * 
  * @author Torstein Svendsen (torstei@officenet.no)
  */