]> source.dussan.org Git - poi.git/commitdiff
Yet more javadoc fixes
authorNick Burch <nick@apache.org>
Fri, 29 Jun 2007 15:01:01 +0000 (15:01 +0000)
committerNick Burch <nick@apache.org>
Fri, 29 Jun 2007 15:01:01 +0000 (15:01 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@551914 13f79535-47bb-0310-9956-ffa450edef68

20 files changed:
src/java/org/apache/poi/hssf/record/CustomField.java
src/java/org/apache/poi/hssf/record/ExternSheetRecord.java
src/java/org/apache/poi/hssf/record/MulBlankRecord.java
src/java/org/apache/poi/hssf/record/MulRKRecord.java
src/java/org/apache/poi/hssf/record/NameRecord.java
src/java/org/apache/poi/hssf/record/NoteRecord.java
src/java/org/apache/poi/hssf/record/PageBreakRecord.java
src/java/org/apache/poi/hssf/record/Record.java
src/java/org/apache/poi/hssf/record/RecordInputStream.java
src/java/org/apache/poi/hssf/record/SSTRecord.java
src/java/org/apache/poi/hssf/record/StringRecord.java
src/java/org/apache/poi/hssf/record/SupBookRecord.java
src/java/org/apache/poi/hssf/record/TopMarginRecord.java
src/java/org/apache/poi/hssf/record/UnknownRecord.java
src/java/org/apache/poi/hssf/record/aggregates/RowRecordsAggregate.java
src/java/org/apache/poi/hssf/record/aggregates/ValueRecordsAggregate.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/usermodel/HSSFDateUtil.java
src/java/org/apache/poi/hssf/usermodel/HSSFFont.java

index d28a611a82db9f3f1db37540af90336fe3720c64..474d3b2b4fac84cf4bac4cdc5561080d89281866 100644 (file)
@@ -28,10 +28,7 @@ public interface CustomField
 
     /**
      * Populates this fields data from the byte array passed in.
-     * @param   data raw data
-     * @param   size size of data
-     * @param   offset of the record's data (provided a big array of the file)
-     * @return  the number of bytes read.
+     * @param in the RecordInputstream to read the record from
      */
     int fillField(RecordInputStream in);
 
index 95c4442b15391ff135701ed2160080ec3d51474f..0d1823a7c49286befae8c2b3419fcdf2a09cb098 100644 (file)
@@ -65,9 +65,7 @@ public class ExternSheetRecord extends Record {
      * called by the constructor, should set class level fields.  Should throw
      * runtime exception for bad/icomplete data.
      *
-     * @param data raw data
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
+     * @param in the RecordInputstream to read the record from
      */
     protected void fillFields(RecordInputStream in) {
         field_2_REF_structures           = new ArrayList();
index b3ea117475659cd75e819d580b710e0a15e174a8..dffdb2fe80673f010b40c648a8efe47c1aa9bae3 100644 (file)
@@ -118,9 +118,7 @@ public class MulBlankRecord
 
     /**
      * @param in the RecordInputstream to read the record from
-     * @param size size of data
      */
-
     protected void fillFields(RecordInputStream in)
     {
         //field_1_row       = LittleEndian.getShort(data, 0 + offset);
index 3aed6d00d5021e32c3d3fa65106eddee0b7adc13..397b979519d506fca19c6ea165620bab5f86fd0c 100644 (file)
@@ -121,9 +121,7 @@ public class MulRKRecord
 
     /**
      * @param in the RecordInputstream to read the record from
-     * @param size size of data
      */
-
     protected void fillFields(RecordInputStream in)
     {
         //field_1_row       = LittleEndian.getShort(data, 0 + offset);
index 97c9747caca7ec29f9a89fdfbf4fa1ade2f1cff5..c920a4afc192bf24814e1c27eb38c3a934b5a6fb 100644 (file)
@@ -491,7 +491,8 @@ public class NameRecord extends Record {
     /**
      * called by the class that is responsible for writing this sucker.
      * Subclasses should implement this so that their data is passed back in a
-     * @param in the RecordInputstream to read the record from
+        * @param offset to begin writing at
+        * @param data byte array containing instance data
      * @return number of bytes written
      */
     public int serialize( int offset, byte[] data )
index 018ae7e76d911cb2ef57b5c0d5a438fb5e394e15..63c0b1d7dcec30df41e5c7df1fe7417d653d48d0 100644 (file)
@@ -194,8 +194,8 @@ public class NoteRecord extends Record {
      * Options flags.
      *
      * @return the options flag
-     * @see NoteRecord.NOTE_VISIBLE
-     * @see NoteRecord.NOTE_HIDDEN
+     * @see #NOTE_VISIBLE
+     * @see #NOTE_HIDDEN
      */
     public short getFlags(){
         return field_3_flags;
index 1b55d031523a7c9df5c4bc1f80fb0ba61cd3c9bb..83eade95d2b509c9156f258f5dcde4e85ee47c08 100644 (file)
@@ -35,14 +35,7 @@ import org.apache.poi.util.LittleEndian;
  * <p>REFERENCE:  Microsoft Excel SDK page 322 and 420</p>
  * 
  * @see HorizontalPageBreakRecord
-<<<<<<< PageBreakRecord.java
- * @see VerticalPageBreakREcord
- *
- * REFERENCE:  Microsoft Excel SDK page 322 and 420
-=======
  * @see VerticalPageBreakRecord
- * 
->>>>>>> 1.5
  * @author Danny Mui (dmui at apache dot org)
  */
 public class PageBreakRecord extends Record {
index 133fe8d5ce76421f4334a546122a8d4722074f21..3205c5774041578eee7b6ed329afa1c71981e21d 100644 (file)
@@ -66,9 +66,7 @@ public abstract class Record
      * called by the constructor, should set class level fields.  Should throw
      * runtime exception for bad/icomplete data.
      *
-     * @param data raw data
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
+     * @param in the RecordInputstream to read the record from
      */
 
     protected abstract void fillFields(RecordInputStream in);
index 01a8df58dd923ba629f1e1559af91fdc03566e6e..fc861f39004e7796d9a1a9559821ae1ede2f05c0 100755 (executable)
@@ -220,7 +220,7 @@ public class RecordInputStream extends InputStream
    *     
    * { 0x16, 0x00 } -0x16     
    *      
-   * @param len the length of the final string
+   * @param length the length of the final string
    * @return                                     the converted string
    * @exception  IllegalArgumentException        if len is too large (i.e.,
    *      there is not enough data in string to create a String of that     
index fe24a3add4070ce4f9e1c926b93ebafc97f9afde..9c67c8dca45b3cf74c1d9c6cb833d986e04a2d4f 100644 (file)
@@ -93,10 +93,7 @@ public class SSTRecord
     /**
      * Constructs an SST record and sets its fields appropriately.
      *
-     * @param id must be 0xfc or an exception will be throw upon
-     *           validation
-     * @param size the size of the data area of the record
-     * @param data of the record (should not contain sid/len)
+     * @param in the RecordInputstream to read the record from
      */
 
     public SSTRecord( RecordInputStream in )
@@ -352,8 +349,7 @@ public class SSTRecord
      * associated data. The UnicodeString class can handle the byte[]
      * vs short[] nature of the actual string data
      *
-     * @param data raw data
-     * @param size size of the raw data
+     * @param in the RecordInputstream to read the record from
      */
 
     protected void fillFields( RecordInputStream in )
index 61e6975f13a372f92b4ab029b6129a312888cc23..a880d7235b1e4d7fb7c59fea7861622b95fc25fb 100644 (file)
@@ -67,8 +67,6 @@ public class StringRecord
 
     /**
      * @param in the RecordInputstream to read the record from
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
      */
     protected void fillFields( RecordInputStream in)
     {
index 5d435194ef1a2160ecb314b4eb8b8153c8a1ea6e..91a16f0793451561008b01d3efde216d58ea1ba4 100644 (file)
@@ -62,8 +62,6 @@ public class SupBookRecord extends Record
 
     /**
      * @param in the RecordInputstream to read the record from
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
      */
     protected void fillFields(RecordInputStream in)
     {
index 295e3e0c77eea9433526068d8c62cc27fb524196..5c507a211ba7cbb4b6a6e3a939fcfc0a9d8178de 100644 (file)
@@ -35,10 +35,7 @@ public class TopMarginRecord extends Record implements Margin
     /**
      * Constructs a TopMargin record and sets its fields appropriately.
      *
-     * @param id    id must be 0x28 or an exception
-     *               will be throw upon validation
-     * @param size  size the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
+     * @param in the RecordInputstream to read the record from
      */
     public TopMarginRecord( RecordInputStream in )
     {        super( in );    }
@@ -56,6 +53,9 @@ public class TopMarginRecord extends Record implements Margin
         }
     }
 
+    /**
+     * @param in the RecordInputstream to read the record from
+     */
     protected void fillFields( RecordInputStream in )
     {
         field_1_margin = in.readDouble();
@@ -102,4 +102,4 @@ public class TopMarginRecord extends Record implements Margin
         rec.field_1_margin = this.field_1_margin;
         return rec;
     }
-}  // END OF CLASS
\ No newline at end of file
+}  // END OF CLASS
index f6770a613eb2e02bb84e1705c64efa7c3b834690..d3e76a020f0ec49ec730d76e094d9c555f5ede79 100644 (file)
@@ -136,9 +136,7 @@ public class UnknownRecord
      * called by the constructor, should set class level fields.  Should throw
      * runtime exception for bad/icomplete data.
      *
-     * @param data raw data
-     * @param size size of data
-     * @param offset of the records data (provided a big array of the file)
+     * @param in the RecordInputstream to read the record from
      */
 
     protected void fillFields(RecordInputStream in)
index abef0159c5a0cb3311888959cb4bf7c753a452e6..44d37de36bf302b068187dddc089297e1e5c5b21 100644 (file)
@@ -230,14 +230,8 @@ public class RowRecordsAggregate
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
-     * runtime exception for bad/incomplete data.
-     *
-     * @param data raw data
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
+     * You never fill an aggregate
      */
-
     protected void fillFields(RecordInputStream in)
     {
     }
index 80b932c51c866903bb1cab84bc813e1e18d436b5..fe3af5aedede6d9fc3a58211bcda7fa5a06bc3e6 100644 (file)
@@ -242,14 +242,8 @@ public class ValueRecordsAggregate
 
     
     /**
-     * called by the constructor, should set class level fields.  Should throw
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
-     * @param size size of data
-     * @param offset of the record's data (provided a big array of the file)
+     * You never fill an aggregate
      */
-
     protected void fillFields(RecordInputStream in)
     {
     }
index 052f7d9bbfea5ccb83cd5f5a0441520a7b488219..6d66307b3d3b921ec0707042471d293acf13a7c9 100644 (file)
@@ -49,8 +49,7 @@ public class GreaterThanPtg
 
     /**
      * Constructor. Create a new GreaterThanPtg.
-     * @param data the byte array to have the PTG added to
-     * @param offset the offset to the PTG to.
+     * @param in the RecordInputstream to read the record from
      */
     public GreaterThanPtg(RecordInputStream in)
     {
index 07baf360016a2e6333be61e50b70562045c04d72..4bccd9274ed449ceab58ddc71697e89146c20a14 100644 (file)
@@ -58,8 +58,7 @@ public class LessThanPtg
 
     /**
      * Constructor. Create a new LessThanPtg.
-     * @param data the byte array to have the PTG added to
-     * @param offset the offset to the PTG to.
+     * @param in the RecordInputstream to read the record from
      */
     public LessThanPtg(RecordInputStream in)
     {
index 00ca868fe3ce2bb57f75de2e314c5ed51c9ffbc2..9bda5dd5d1e6777518fb74ae63a1069bc6255d90 100644 (file)
@@ -160,6 +160,7 @@ public class HSSFDateUtil
      *  
      * @param formatIndex The index of the format, eg from ExtendedFormatRecord.getFormatIndex
      * @param formatString The format string
+     * @see #isInternalDateFormat(int,String) 
      */
     public static boolean isADateFormat(int formatIndex, String formatString) {
        // First up, is this an internal date format?
@@ -187,7 +188,7 @@ public class HSSFDateUtil
     /**
      * Given a format ID this will check whether the format represents
      *  an internal excel date format or not.
-     * @see isDateFormat(int,String) 
+     * @see #isDateFormat(int,String) 
      */
     public static boolean isInternalDateFormat(int format) {
       boolean retval =false;
index 9d2f79678839f0053c0172804c2aba2538343175..852e15ee28026107bd6304df6dfeda752fd0a53c 100644 (file)
@@ -383,7 +383,6 @@ public class HSSFFont
 
     /**
      * set character-set to use.
-     * @return character-set
      * @see #ANSI_CHARSET
      * @see #DEFAULT_CHARSET
      * @see #SYMBOL_CHARSET