]> source.dussan.org Git - poi.git/commitdiff
More Javadoc issues fixed. "ant javadoc" now runs without any complaints. However...
authorRainer Klute <klute@apache.org>
Sat, 6 Dec 2003 11:01:19 +0000 (11:01 +0000)
committerRainer Klute <klute@apache.org>
Sat, 6 Dec 2003 11:01:19 +0000 (11:01 +0000)
git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@353467 13f79535-47bb-0310-9956-ffa450edef68

28 files changed:
src/contrib/src/org/apache/poi/hssf/contrib/view/SVTableUtils.java
src/java/org/apache/poi/hssf/eventusermodel/AbortableHSSFListener.java
src/java/org/apache/poi/hssf/eventusermodel/HSSFRequest.java
src/java/org/apache/poi/hssf/record/BOFRecord.java
src/java/org/apache/poi/hssf/record/CodepageRecord.java
src/java/org/apache/poi/hssf/record/ExtendedFormatRecord.java
src/java/org/apache/poi/hssf/record/PaletteRecord.java
src/java/org/apache/poi/hssf/record/formula/Area3DPtg.java
src/java/org/apache/poi/hssf/record/formula/AreaPtg.java
src/java/org/apache/poi/hssf/record/formula/GreaterThanPtg.java
src/java/org/apache/poi/hssf/record/formula/LessThanPtg.java
src/java/org/apache/poi/hssf/record/formula/Ptg.java
src/java/org/apache/poi/hssf/usermodel/HSSFFont.java
src/java/org/apache/poi/hssf/usermodel/HSSFName.java
src/java/org/apache/poi/hssf/usermodel/HSSFRow.java
src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
src/java/org/apache/poi/poifs/filesystem/POIFSDocumentPath.java
src/java/org/apache/poi/poifs/storage/BlockAllocationTableWriter.java
src/java/org/apache/poi/poifs/storage/SmallBlockTableWriter.java
src/java/org/apache/poi/util/CommonsLogger.java
src/java/org/apache/poi/util/NullLogger.java
src/java/org/apache/poi/util/POILogger.java
src/java/org/apache/poi/util/StringUtil.java
src/scratchpad/src/org/apache/poi/hwpf/model/hdftypes/CHPFormattedDiskPage.java
src/scratchpad/src/org/apache/poi/hwpf/model/hdftypes/PAPFormattedDiskPage.java
src/scratchpad/src/org/apache/poi/hwpf/model/hdftypes/PropertyNode.java
src/scratchpad/src/org/apache/poi/hwpf/model/hdftypes/StyleSheet.java
src/scratchpad/src/org/apache/poi/hwpf/model/hdftypes/TextPiece.java

index a5259910a40e7a3fb4430890a4ec8affb259d5d3..d17acc45071f7e7e114f82ac788e19a2e7dfa688 100644 (file)
@@ -79,10 +79,6 @@ public class SVTableUtils {
 
   /**
    *  Creates a new font for a specific cell style
-   *
-   * @param  wb     Description of the Parameter
-   * @param  style  Description of the Parameter
-   * @return        Description of the Return Value
    */
   public static Font makeFont(HSSFFont font) {
     boolean isbold = font.getBoldweight() > HSSFFont.BOLDWEIGHT_NORMAL;
index 697df33d381fe8697a489ce1dfef47933f5ddcc8..63d28dad3fa5c78fd16d0b00f6ecfe5ee6b22415 100644 (file)
@@ -63,9 +63,9 @@ import org.apache.poi.hssf.eventusermodel.HSSFUserException;
  * a listener supporting this interface and register it with the HSSFRequest (associating
  * it with Record SID's).
  *
- * @see org.apache.poi.hssf.eventusermodel.HSSFEventFactory
- * @see org.apache.poi.hssf.eventusermodel.HSSFRequest
- * @see org.apache.poi.hssf.HSSFUserException
+ * @see HSSFEventFactory
+ * @see HSSFRequest
+ * @see AbortableHSSFListener
  *
  * @author Carey Sublette (careysub@earthling.net)
  *
index eef1d0a697bb7f2aa77a14ca08acc989c1351983..5ecc4ddeaa23aa2f9832d954d3c1c948ee6284a3 100644 (file)
@@ -66,10 +66,10 @@ import org.apache.poi.hssf.record.RecordFactory;
  * An HSSFRequest object should be constructed registering an instance or multiple
  * instances of HSSFListener with each Record.sid you wish to listen for.
  *
- * @see org.apache.poi.hssf.eventmodel.HSSFEventFactory
- * @see org.apache.poi.hssf.eventmodel.HSSFListener
+ * @see org.apache.poi.hssf.eventusermodel.HSSFEventFactory
+ * @see org.apache.poi.hssf.eventusermodel.HSSFRequest
  * @see org.apache.poi.hssf.dev.EFHSSF
- * @see org.apache.poi.hssf.HSSFUserException
+ * @see org.apache.poi.hssf.eventusermodel.HSSFUserException
  * @author  Andrew C. Oliver (acoliver at apache dot org)
  * @author Carey Sublette (careysub@earthling.net)
  */
index a44cc08339e1ca24da39abae51bfc9c17f0cf3b2..54a5ddb629b218dbecdfd06d6ac5bc0a25129d26 100644 (file)
@@ -212,7 +212,7 @@ public class BOFRecord
     /**
      * Year of the build that wrote this file
      * @see #BUILD_YEAR
-     * @param build year to set
+     * @param year year to set
      */
 
     public void setBuildYear(short year)
index ab6a21ed7c625a5e2cc2c49d0a1d49d42a5203a7..dc1c4aae9f32e8a65a81b833ce09707bf99e02a1 100644 (file)
@@ -127,7 +127,7 @@ public class CodepageRecord
      * set the codepage for this workbook
      *
      * @see #CODEPAGE
-     * @param the codepage to set
+     * @param cp the codepage to set
      */
 
     public void setCodepage(short cp)
index fad8f733459740cb8cf4dbce277d689e5d9d38c1..4d4f95eaba5b3e6167a21f12290c7fcbb871f3d9 100644 (file)
@@ -641,8 +641,8 @@ public class ExtendedFormatRecord
      * set whether or not to use the pattern in this XF instead of the parent XF.
      * (foregrount/background)
      *
-     * @param pattern- true if this XF has a different pattern value than its parent,
-     *                 false otherwise.
+     * @param pattern true if this XF has a different pattern value than its parent,
+     *                false otherwise.
      * @see #setIndentionOptions(short)
      */
 
@@ -657,8 +657,8 @@ public class ExtendedFormatRecord
      * set whether or not to use the locking/hidden in this XF instead of the parent XF.
      *
      *
-     * @param options- true if this XF has a different locking or hidden value than its parent,
-     *                 false otherwise.
+     * @param options true if this XF has a different locking or hidden value than its parent,
+     *                false otherwise.
      * @see #setIndentionOptions(short)
      */
 
index e538511217a59012acf4c53446782e6cb521940c..f1d6d08a5f3e166675067070bc52806841c17547 100644 (file)
@@ -205,8 +205,8 @@ public class PaletteRecord
      * If the given index is greater than the current last color index,
      * then black is inserted at every index required to make the palette continuous.
      *
-     * @param i the index to set; if this index is less than 0x8 or greater than
-     * 0x40, then no modification is made
+     * @param byteIndex the index to set; if this index is less than 0x8 or 
+     * greater than 0x40, then no modification is made
      */
     public void setColor(short byteIndex, byte red, byte green, byte blue)
     {
index 89401a981d362b7558756716bd4bd51819df51ad..34e056dfac57505002c2bee77aabfbbd430d98b6 100644 (file)
@@ -236,7 +236,7 @@ public class Area3DPtg extends Ptg
 
        /**
         * sets the first row to relative or not
-        * @param isRelative or not.
+         * @param rel specifies whether the first row is relative or not
         */
        public void setFirstRowRelative( boolean rel )
        {
@@ -253,7 +253,7 @@ public class Area3DPtg extends Ptg
 
        /**
         * set whether the last row is relative or not
-        * @param last row relative
+        * @param rel specifies whether the last row is relative
         */
        public void setLastRowRelative( boolean rel )
        {
index 3189a2c85665b97eceee6586ae830b5fb3561042..02c63ea1c9bdcfa4b9458b86d5836a688f39579c 100644 (file)
@@ -171,7 +171,7 @@ public class AreaPtg
     }
 
     /**
-     * @param last row number in the area 
+     * @param row last row number in the area 
      */
     public void setLastRow(short row)
     {
@@ -267,7 +267,7 @@ public class AreaPtg
     
     /**
      * set whether the last row is relative or not
-     * @param last row relative
+     * @param rel specifies whether the last row is relative or not
      */
     public void setLastRowRelative(boolean rel) {
         field_4_last_column=rowRelative.setShortBoolean(field_4_last_column,rel);
index 04fbcac2ef9517eafe80d411e51a53c70c8d46a5..9b87e68331ac0af1ae81df501d7e54949bbdf966 100644 (file)
@@ -131,11 +131,10 @@ public class GreaterThanPtg
     
     /** 
      * Implementation of method from Ptg 
-     * @param refs the Sheet References
      */
     public String toFormulaString(Workbook book)
     {
-        return this.GREATERTHAN;
+        return GreaterThanPtg.GREATERTHAN;
     }
       
     /** 
index a856b93bde5ac65a88d0867fa59ce4d40d6ebc3c..6b66ea732b263553fcaa100608c53be2e3edf093 100644 (file)
@@ -140,11 +140,10 @@ public class LessThanPtg
     
     /** 
      * Implementation of method from Ptg 
-     * @param refs the Sheet References
      */
     public String toFormulaString(Workbook book)
     {
-        return this.LESSTHAN;
+        return LessThanPtg.LESSTHAN;
     }
        
     /** 
index cdf584ed1ab8b15612c592d05409aafa12fc77f5..4b00c8e415c4e8e183ca03b1e807190c829dfc92 100644 (file)
@@ -75,16 +75,16 @@ import org.apache.poi.hssf.model.Workbook;
 public abstract class Ptg
 {
 
-        
-    /** convert infix order ptg list to rpn order ptg list
-     * @return List ptgs in RPN order
-     * @param infixPtgs List of ptgs in infix order
-     */
     
     /* DO NOT REMOVE
      *we keep this method in case we wish to change the way we parse
      *It needs a getPrecedence in OperationsPtg
     
+    /** convert infix order ptg list to rpn order ptg list
+     * @return List ptgs in RPN order
+     * @param infixPtgs List of ptgs in infix order
+     */
+    /*
     public static List ptgsToRpn(List infixPtgs) {
         java.util.Stack operands = new java.util.Stack();
         java.util.List retval = new java.util.Stack();
index 8a269543d9deedd0cc102391c7ee634ec8e5d8a8..016c0d42f1f7483907380f1fa8148da529c5f087 100644 (file)
@@ -165,7 +165,7 @@ public class HSSFFont
 
     /**
      * set the name for the font (i.e. Arial)
-     * @param String representing the name of the font to use
+     * @param name the name of the font to use
      * @see #FONT_ARIAL
      */
 
@@ -245,7 +245,7 @@ public class HSSFFont
 
     /**
      * set whether to use italics or not
-     * @param italics or not
+     * @param italic use italics or not
      */
 
     public void setItalic(boolean italic)
@@ -359,7 +359,7 @@ public class HSSFFont
 
     /**
      * set type of text underlining to use
-     * @param underlining type
+     * @param underline the underlining type to use
      * @see #U_NONE
      * @see #U_SINGLE
      * @see #U_DOUBLE
index 8c186340259ed972c2a31c28fc1351ece8798a38..0d1a87453d5b986ad17a7ff7c819196961142663 100644 (file)
@@ -74,8 +74,8 @@ public class HSSFName {
      *
      * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#createName()
      * @param name the Name Record
-     * @param book lowlevel Workbook object associated with the sheet.
-     * @param book the Workbook */
+     * @param book lowlevel Workbook object associated with the sheet.
+     */
     
     protected HSSFName(Workbook book, NameRecord name) {
         this.book = book;
index 962a0e6e354b69248bd90d76d2a2d7b733967cea..c51f27abb34c4237a6edffd00631f8257e1e430e 100644 (file)
@@ -117,7 +117,7 @@ public class HSSFRow
      * @param book low-level Workbook object containing the sheet that contains this row
      * @param sheet low-level Sheet object that contains this Row
      * @param rowNum the row number of this row (0 based)
-     * @see org.apache.poi.hssf.usermodel.HSSFSheet#createRow(short)
+     * @see org.apache.poi.hssf.usermodel.HSSFSheet#createRow(int)
      */
 
     //protected HSSFRow(Workbook book, Sheet sheet, short rowNum)
@@ -143,7 +143,7 @@ public class HSSFRow
      * @param book low-level Workbook object containing the sheet that contains this row
      * @param sheet low-level Sheet object that contains this Row
      * @param record the low level api object this row should represent
-     * @see org.apache.poi.hssf.usermodel.HSSFSheet#createRow(short)
+     * @see org.apache.poi.hssf.usermodel.HSSFSheet#createRow(int)
      */
 
     protected HSSFRow(Workbook book, Sheet sheet, RowRecord record)
index e3fd336168c0dd85702f975033d540b6213c5b3e..02bdc81167395e6dafefeda324108fca82fec72c 100644 (file)
@@ -273,8 +273,8 @@ public class HSSFWorkbook
      * set the sheet name. 
      * Will throw IllegalArgumentException if the name is greater than 31 chars
      * or contains /\?*[]
-     * @param sheet number (0 based)
-     * @param sheet name
+     * @param sheet sheet number (0 based)
+     * @param name sheet name
      */
 
     public void setSheetName(int sheet, String name)
index ed6e9e5f7bf9badbece5a1975509565fd352fc1c..e4a560b5902c0f43c7c88d7df1a8e96f91c9c93c 100644 (file)
@@ -263,10 +263,9 @@ public class POIFSDocumentPath
      * <p>Returns the path's parent or <code>null</code> if this path
      * is the root path.</p>
      *
-     * @author Rainer Klute (klute@rainer-klute.de)
-     * @since 2002-01-24
-     *
      * @return path of parent, or null if this path is the root path
+     * 
+     * @since 2002-01-24
      */
 
     public POIFSDocumentPath getParent()
@@ -288,10 +287,9 @@ public class POIFSDocumentPath
      * <p>Returns a string representation of the path. Components are
      * separated by the platform-specific file separator.</p>
      *
-     * @author Rainer Klute (klute@rainer-klute.de)
-     * @since 2002-01-24
-     *
      * @return string representation
+     *
+     * @since 2002-01-24
      */
 
     public String toString()
index 001b67f8ce43ff8264c617e01eb42c2078427637..df584470fbdaea28e9fb789ef73d3692fe7d8c71 100644 (file)
@@ -225,9 +225,6 @@ public class BlockAllocationTableWriter
     /**
      * Set the start block for this instance
      *
-     * @param index index into the array of BigBlock instances making
-     *              up the the filesystem
-     *
      * @param start_block
      */
 
index 5bd06bf927e6943ed2972c9932f67a79d8917502..3d9420fd828c339dc2b24263ea22470cd3552073 100644 (file)
@@ -150,9 +150,6 @@ public class SmallBlockTableWriter
     /**
      * Set the start block for this instance
      *
-     * @param index index into the array of BigBlock instances making
-     *              up the the filesystem
-     *
      * @param start_block
      */
 
index f82f4d76874d17e6c380d8a387a0fd0a14d19864..ab0943e2ae3b01b58180467e5e1b396183e5852f 100644 (file)
@@ -141,7 +141,6 @@ public class CommonsLogger extends POILogger
      * Check if a logger is enabled to log at the specified level
      *
      * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
-     * @param obj1 The logger to check.
      */
 
     public boolean check(final int level)
index fa372ebbceee6bd401babbd9e0ad801b15ae0dae..163490cb122d6e9f88246107c07b66e98beda9bd 100644 (file)
@@ -91,7 +91,6 @@ public class NullLogger extends POILogger
      * Check if a logger is enabled to log at the specified level
      *
      * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
-     * @param obj1 The logger to check.
      */
 
     public boolean check(final int level)
index c3dce69cab24ede561a904cdc00c948bb5fb1eec..023dd52e580d134a85561feb3e452a6dfd965981 100644 (file)
@@ -94,7 +94,6 @@ public abstract class POILogger
      * Check if a logger is enabled to log at the specified level
      *
      * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
-     * @param obj1 The logger to check.
      */
     abstract public boolean check(final int level);
 
index c856b0181d84d13806100c0c01db157b3cbe72bf..e883e3d12b74aca4cd38d8ed28c8868f42052b44 100644 (file)
@@ -86,7 +86,7 @@ public class StringUtil {
         *@param  offset                              the initial offset into the     
         *      byte array. it is assumed that string[ offset ] and string[ offset +     
         *     1 ] contain the first 16-bit unicode character     
-        *@param  len     
+         *@param len the length of the final string     
         *@return                                     the converted string     
         *@exception  ArrayIndexOutOfBoundsException  if offset is out of bounds for     
         *      the byte array (i.e., is negative or is greater than or equal to     
@@ -94,7 +94,6 @@ public class StringUtil {
         *@exception  IllegalArgumentException        if len is too large (i.e.,     
         *      there is not enough data in string to create a String of that     
         *      length)     
-        *@param len the length of the final string     
         */
        public static String getFromUnicodeLE(
                final byte[] string,
@@ -138,7 +137,7 @@ public class StringUtil {
         **@param  offset                              the initial offset into the     
         *      byte array. it is assumed that string[ offset ] and string[ offset +     
         *      1 ] contain the first 16-bit unicode character     
-        *@param  len     
+         *@param len the length of the final string     
         *@return                                     the converted string     
         *@exception  ArrayIndexOutOfBoundsException  if offset is out of bounds for     
         *      the byte array (i.e., is negative or is greater than or equal to     
@@ -146,7 +145,6 @@ public class StringUtil {
         *@exception  IllegalArgumentException        if len is too large (i.e.,     
         *      there is not enough data in string to create a String of that     
         *      length)     
-        *@param len the length of the final string     
         */
        public static String getFromUnicodeBE(
                final byte[] string,
index 5a5d9e4907d0dfffdf68b3150f8588dfb98dc692..39beb5918ef0953772251a07cd0a9833ba1f5e35 100644 (file)
@@ -89,8 +89,6 @@ public class CHPFormattedDiskPage extends FormattedDiskPage
     /**
      * This constructs a CHPFormattedDiskPage from a raw fkp (512 byte array
      * read from a Word file).
-     *
-     * @param fkp The 512 byte array to read data from
      */
     public CHPFormattedDiskPage(byte[] documentStream, int offset, int fcMin)
     {
index f9ca0e3901d1ac4b1f8d6a9adc3458a03a49aefc..4c6ebb9c91ed54d7a7c1e1de42a6abffbed58f97 100644 (file)
@@ -93,8 +93,6 @@ public class PAPFormattedDiskPage extends FormattedDiskPage
 
     /**
      * Creates a PAPFormattedDiskPage from a 512 byte array
-     *
-     * @param fkp a 512 byte array.
      */
     public PAPFormattedDiskPage(byte[] documentStream, int offset, int fcMin)
     {
index 8ff76816da72da87fec49240efb402246a9d3f67..972ea9c3cc4ac5208da7091d2d6b091d66f7f50e 100644 (file)
@@ -74,7 +74,6 @@ public class PropertyNode implements Comparable
   /**
    * @param fcStart The start of the text for this property.
    * @param fcEnd The end of the text for this property.
-   * @param grpprl The property description in compressed form.
    */
   public PropertyNode(int fcStart, int fcEnd, Object buf)
   {
@@ -97,7 +96,7 @@ public class PropertyNode implements Comparable
   }
 
   /**
-   * @retrun The offset of the end of this property's text.
+   * @return The offset of the end of this property's text.
    */
   public int getEnd()
   {
index 2d597180f45bda4bbe7dd24abdd3a80cd47480ce..68a117bf075ce43d20eb630cf6009308236aeda0 100644 (file)
@@ -98,10 +98,6 @@ public class StyleSheet implements HDFType
 
   /**
    * StyleSheet constructor. Loads a document's stylesheet information,
-   *
-   * @param styleSheet A byte array containing a document's raw stylesheet
-   *        info. Found by using FileInformationBlock.getFcStshf() and
-   *        FileInformationBLock.getLcbStshf()
    */
   public StyleSheet(byte[] tableStream, int offset)
   {
index 4c9db046718dff5a41ed817c3bde55f36d8050c0..4065a86dadca1b98d1c1e9b5ce710b2f11273706 100644 (file)
@@ -70,9 +70,6 @@ public class TextPiece extends PropertyNode implements Comparable
 
   /**
    * @param start Offset in main document stream.
-   * @param length The total length of the text in bytes. Note: 1 character
-   *        does not necessarily refer to 1 byte.
-   * @param unicode true if this text is unicode.
    */
   public TextPiece(int start, int end, byte[] text, PieceDescriptor pd)
     throws UnsupportedEncodingException