Lots more javadoc warning fixes

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

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

@@ -52,12 +52,8 @@ public abstract class AbstractEscherHolderRecord
     /**
      * Constructs a Bar record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1017 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
-
     public AbstractEscherHolderRecord(RecordInputStream in)
     {
         super(in);

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

@@ -52,10 +52,7 @@ public class AreaFormatRecord
     /**
      * Constructs a AreaFormat record and sets its fields appropriately.
      *
-     * @param id    id must be 0x100a or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AreaFormatRecord(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class AreaRecord
     /**
      * Constructs a Area record and sets its fields appropriately.
      *
-     * @param id    id must be 0x101A or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AreaRecord(RecordInputStream in)

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

@@ -49,10 +49,7 @@ public class AxisLineFormatRecord
     /**
      * Constructs a AxisLineFormat record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1021 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AxisLineFormatRecord(RecordInputStream in)

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

@@ -61,10 +61,7 @@ public class AxisOptionsRecord
     /**
      * Constructs a AxisOptions record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1062 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AxisOptionsRecord(RecordInputStream in)

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

@@ -51,10 +51,7 @@ public class AxisParentRecord
     /**
      * Constructs a AxisParent record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1041 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AxisParentRecord(RecordInputStream in)

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

@@ -52,10 +52,7 @@ public class AxisRecord
     /**
      * Constructs a Axis record and sets its fields appropriately.
      *
-     * @param id    id must be 0x101d or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AxisRecord(RecordInputStream in)

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

@@ -45,10 +45,7 @@ public class AxisUsedRecord
     /**
      * Constructs a AxisUsed record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1046 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public AxisUsedRecord(RecordInputStream in)

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

@@ -88,10 +88,7 @@ public class BOFRecord
 
     /**
      * Constructs a BOFRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x809 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BOFRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class BackupRecord
 
     /**
      * Constructs a BackupRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x40 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BackupRecord(RecordInputStream in)

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

@@ -51,10 +51,7 @@ public class BarRecord
     /**
      * Constructs a Bar record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1017 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public BarRecord(RecordInputStream in)

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

@@ -41,10 +41,7 @@ public class BeginRecord
 
     /**
      * Constructs a BeginRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x1033 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BeginRecord(RecordInputStream in)

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

@@ -53,10 +53,7 @@ public class BlankRecord
 
     /**
      * Constructs a BlankRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x201 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BlankRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class BookBoolRecord
 
     /**
      * Constructs a BookBoolRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xDA or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BookBoolRecord(RecordInputStream in)

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

@@ -55,9 +55,7 @@ public class BoolErrRecord
     /**
      * Constructs a BoolErr record and sets its fields appropriately.
      *
-     * @param id     id must be 0x205 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BoolErrRecord(RecordInputStream in)
@@ -66,11 +64,7 @@ public class BoolErrRecord
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
-     * @param size size of data
      */
 
     protected void fillFields(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class BottomMarginRecord
     /**
      * Constructs a BottomMargin record and sets its fields appropriately.
      *
-     * @param id   id must be 0x29 or an exception
+     * @param in the RecordInputstream to read the record from
-     *             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)
      */
     public BottomMarginRecord( RecordInputStream in )
     {

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

@@ -50,9 +50,7 @@ public class BoundSheetRecord
     /**
      * Constructs a BoundSheetRecord and sets its fields appropriately
      *
-     * @param id     id must be 0x85 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public BoundSheetRecord( RecordInputStream in )

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

@@ -47,10 +47,7 @@ public class CalcCountRecord
 
     /**
      * Constructs a CalcCountRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xC or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      *
      */
 

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

@@ -63,10 +63,7 @@ public class CalcModeRecord
 
     /**
      * Constructs a CalcModeRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xD or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public CalcModeRecord(RecordInputStream in)

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

@@ -51,10 +51,7 @@ public class CategorySeriesAxisRecord
     /**
      * Constructs a CategorySeriesAxis record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1020 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public CategorySeriesAxisRecord(RecordInputStream in)

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

@@ -50,10 +50,7 @@ public class ChartFormatRecord
 
     /**
      * Constructs a ChartFormatRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id    id must equal the sid or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public ChartFormatRecord(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class ChartRecord
     /**
      * Constructs a Chart record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1002 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public ChartRecord(RecordInputStream in)

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

@@ -49,10 +49,7 @@ public class CodepageRecord
 
     /**
      * Constructs a CodepageRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x42 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public CodepageRecord(RecordInputStream in)

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

@@ -56,10 +56,7 @@ public class ColumnInfoRecord
 
     /**
      * Constructs a ColumnInfo record and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x7d or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public ColumnInfoRecord(RecordInputStream in)

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

@@ -85,10 +85,7 @@ public class CommonObjectDataSubRecord
     /**
      * Constructs a CommonObjectData record and sets its fields appropriately.
      *
-     * @param id    id must be 0x15 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public CommonObjectDataSubRecord(RecordInputStream in)

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

@@ -48,9 +48,7 @@ public class ContinueRecord
     /**
      * Main constructor -- kinda dummy because we don't validate or fill fields
      *
-     * @param id record id
+     * @param in the RecordInputstream to read the record from
-     * @param size record size
-     * @param data raw data
      */
 
     public ContinueRecord(RecordInputStream in)
@@ -80,9 +78,8 @@ public class ContinueRecord
         //    "You're not supposed to serialize Continue records like this directly");
     }
 
-    /**
+	/*
-     * set the data for continuation
+     * @param data raw data
-     * @param data - a byte array containing all of the continued data
      */
 
     public void setData(byte [] data)
@@ -139,9 +136,7 @@ public class ContinueRecord
     /**
      * Fill the fields. Only thing is, this record has no fields --
      *
-     * @param ignored_parm1 Ignored
+     * @param in the RecordInputstream to read the record from
-     * @param ignored_parm2 Ignored
-     * @param ignored_parm3 Ignored
      */
 
     protected void fillFields(RecordInputStream in)

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

@@ -46,10 +46,7 @@ public class CountryRecord
 
     /**
      * Constructs a CountryRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x8c or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public CountryRecord(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class DBCellRecord
 
     /**
      * Constructs a DBCellRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xd7 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DBCellRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class DSFRecord
 
     /**
      * Constructs a DBCellRecord and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x161 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DSFRecord(RecordInputStream in)

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

@@ -49,10 +49,7 @@ public class DatRecord
     /**
      * Constructs a Dat record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1063 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public DatRecord(RecordInputStream in)

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

@@ -49,10 +49,7 @@ public class DataFormatRecord
     /**
      * Constructs a DataFormat record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1006 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public DataFormatRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class DateWindow1904Record
 
     /**
      * Constructs a DateWindow1904 record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x22 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DateWindow1904Record(RecordInputStream in)

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

@@ -43,10 +43,7 @@ public class DefaultColWidthRecord
 
     /**
      * Constructs a DefaultColumnWidth record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x55 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DefaultColWidthRecord(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class DefaultDataLabelTextPropertiesRecord
     /**
      * Constructs a DefaultDataLabelTextProperties record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1024 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public DefaultDataLabelTextPropertiesRecord(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class DefaultRowHeightRecord
 
     /**
      * Constructs a DefaultRowHeight record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x225 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DefaultRowHeightRecord(RecordInputStream in)

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

@@ -46,10 +46,7 @@ public class DeltaRecord
 
     /**
      * Constructs a Delta record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x10 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DeltaRecord(RecordInputStream in)

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

@@ -47,10 +47,7 @@ public class DimensionsRecord
 
     /**
      * Constructs a Dimensions record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x200 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public DimensionsRecord(RecordInputStream in)

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

@@ -43,10 +43,7 @@ public class EOFRecord
 
     /**
      * Constructs a EOFRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x0A or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public EOFRecord(RecordInputStream in)

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

@@ -41,10 +41,7 @@ public class EndRecord
 
     /**
      * Constructs a EndRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x1034 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public EndRecord(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class EndSubRecord
     /**
      * Constructs a End record and sets its fields appropriately.
      *
-     * @param id    id must be 0x00 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public EndSubRecord(RecordInputStream in)

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

@@ -55,10 +55,7 @@ public class ExtSSTRecord
 
     /**
      * Constructs a EOFRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xff or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public ExtSSTRecord(RecordInputStream in)

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

@@ -197,10 +197,7 @@ public class ExtendedFormatRecord
 
     /**
      * Constructs an ExtendedFormat record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xE0 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public ExtendedFormatRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class ExternSheetRecord extends Record {
     
     /**
      * Constructs a Extern Sheet record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x16 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
     
     public ExternSheetRecord(RecordInputStream in) {

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

@@ -44,9 +44,7 @@ public class ExternSheetSubRecord extends Record {
     /**
      * Constructs a Extern Sheet Sub Record record and sets its fields appropriately.
      *
-     * @param id     id must be 0x18 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
     public ExternSheetSubRecord(RecordInputStream in) {
         super(in);
@@ -106,12 +104,7 @@ public class ExternSheetSubRecord extends Record {
     }
     
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * 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)
      */
     protected void fillFields(RecordInputStream in) {
         field_1_index_to_supbook             = in.readShort();

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

@@ -42,10 +42,7 @@ public class FilePassRecord
 
     /**
      * Constructs a FILEPASS record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x84 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FilePassRecord(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class FnGroupCountRecord
 
     /**
      * Constructs a FnGroupCount record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x9c or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FnGroupCountRecord(RecordInputStream in)

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

@@ -49,10 +49,7 @@ public class FontBasisRecord
     /**
      * Constructs a FontBasis record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1060 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public FontBasisRecord(RecordInputStream in)

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

@@ -45,10 +45,7 @@ public class FontIndexRecord
     /**
      * Constructs a FontIndex record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1026 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public FontIndexRecord(RecordInputStream in)

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

@@ -79,10 +79,7 @@ public class FontRecord
     /**
      * Constructs a Font record and sets its fields appropriately.
      *
-     * @param id     id must be 0x31 (NOT 0x231 see MSKB #Q184647 for an "explanation of
+     * @param in the RecordInputstream to read the record from
-     * this bug in the documentation) or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FontRecord(RecordInputStream in)

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

@@ -47,10 +47,7 @@ public class FooterRecord
 
     /**
      * Constructs a FooterRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x15 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FooterRecord(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class FormatRecord
 
     /**
      * Constructs a Format record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x41e or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FormatRecord(RecordInputStream in)

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

@@ -77,11 +77,11 @@ public class FormulaRecord
 
     /**
      * Constructs a Formula record and sets its fields appropriately.
+     * Note - id must be 0x06 (NOT 0x406 see MSKB #Q184647 for an 
+     * "explanation of this bug in the documentation) or an exception
+     *  will be throw upon validation
      *
-     * @param id     id must be 0x06 (NOT 0x406 see MSKB #Q184647 for an "explanation of
+     * @param in the RecordInputstream to read the record from
-     * this bug in the documentation) or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public FormulaRecord(RecordInputStream in)

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

@@ -50,10 +50,7 @@ public class FrameRecord
     /**
      * Constructs a Frame record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1032 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public FrameRecord(RecordInputStream in)

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

@@ -46,10 +46,7 @@ public class GridsetRecord
 
     /**
      * Constructs a GridSet record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x82 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public GridsetRecord(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class GroupMarkerSubRecord
     /**
      * Constructs a group marker record and sets its fields appropriately.
      *
-     * @param id    id must be 0x00 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public GroupMarkerSubRecord(RecordInputStream in)

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

@@ -45,10 +45,7 @@ public class GutsRecord
 
     /**
      * Constructs a Guts record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x80 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public GutsRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class HCenterRecord
 
     /**
      * Constructs an HCenter record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x83 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public HCenterRecord(RecordInputStream in)

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

@@ -47,10 +47,7 @@ public class HeaderRecord
 
     /**
      * Constructs an Header record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x14 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public HeaderRecord(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class HideObjRecord
 
     /**
      * Constructs an HideObj record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x8d or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public HideObjRecord(RecordInputStream in)

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

@@ -44,9 +44,7 @@ public class HorizontalPageBreakRecord extends PageBreakRecord {
 	}
 
    /**
-	 * @param id
+     * @param in the RecordInputstream to read the record from
-	 * @param size
-	 * @param data
 	 */
 	public HorizontalPageBreakRecord(RecordInputStream in) {
 		super(in);

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

@@ -50,10 +50,7 @@ public class IndexRecord
 
     /**
      * Constructs an Index record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x208 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public IndexRecord(RecordInputStream in)

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

@@ -41,10 +41,7 @@ public class InterfaceEndRecord
 
     /**
      * Constructs an InterfaceEnd record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xe2 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public InterfaceEndRecord(RecordInputStream in)

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

@@ -47,10 +47,7 @@ public class InterfaceHdrRecord
 
     /**
      * Constructs an Codepage record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xe1 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public InterfaceHdrRecord(RecordInputStream in)

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

@@ -45,10 +45,7 @@ public class IterationRecord
 
     /**
      * Constructs an Iteration record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x11 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public IterationRecord(RecordInputStream in)

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

@@ -56,9 +56,7 @@ public class LabelRecord
     /**
      * Constructs an Label record and sets its fields appropriately.
      *
-     * @param id     id must be 0x204 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public LabelRecord(RecordInputStream in)
@@ -82,11 +80,7 @@ public class LabelRecord
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
-     * @param size size of data
      */
 
     protected void fillFields(RecordInputStream in)

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

@@ -48,10 +48,7 @@ public class LabelSSTRecord
 
     /**
      * Constructs an LabelSST record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xfd or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public LabelSSTRecord(RecordInputStream in)

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

@@ -34,10 +34,7 @@ public class LeftMarginRecord extends Record implements Margin
     /**
      * Constructs a LeftMargin record and sets its fields appropriately.
      *
-     * @param id    id must be 0x26 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
     public LeftMarginRecord(RecordInputStream in)
     {        super(in);    }

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

@@ -66,10 +66,7 @@ public class LegendRecord
     /**
      * Constructs a Legend record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1015 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public LegendRecord(RecordInputStream in)

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

@@ -65,10 +65,7 @@ public class LineFormatRecord
     /**
      * Constructs a LineFormat record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1007 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public LineFormatRecord(RecordInputStream in)

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

@@ -58,10 +58,7 @@ public class LinkedDataRecord
     /**
      * Constructs a LinkedData record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1051 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public LinkedDataRecord(RecordInputStream in)

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

@@ -43,10 +43,7 @@ public class MMSRecord
 
     /**
      * Constructs a MMS record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xc1 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public MMSRecord(RecordInputStream in)

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

@@ -45,10 +45,7 @@ public class MergeCellsRecord
 
     /**
      * Constructs a MergedCellsRecord and sets its fields appropriately
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param sid     id must be 0xe5 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public MergeCellsRecord(RecordInputStream in)

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

@@ -55,9 +55,7 @@ public class MulBlankRecord
     /**
      * Constructs a MulBlank record and sets its fields appropriately.
      *
-     * @param id     id must be 0xbe or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public MulBlankRecord(RecordInputStream in)
@@ -119,10 +117,7 @@ public class MulBlankRecord
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
      * @param size size of data
      */
 

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

@@ -55,9 +55,7 @@ public class MulRKRecord
     /**
      * Constructs a MulRK record and sets its fields appropriately.
      *
-     * @param id     id must be 0xbd or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public MulRKRecord(RecordInputStream in)
@@ -122,10 +120,7 @@ public class MulRKRecord
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
      * @param size size of data
      */
 

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

@@ -135,9 +135,7 @@ public class NameRecord extends Record {
     /**
      * Constructs a Name record and sets its fields appropriately.
      *
-     * @param id     id must be 0x18 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
     public NameRecord(RecordInputStream in) {
         super(in);
@@ -493,10 +491,7 @@ 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
-     * byte array.
+     * @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 )
@@ -709,9 +704,7 @@ public class NameRecord extends Record {
      * called by the constructor, should set class level fields.  Should throw
      * runtime exception for bad/icomplete data.
      *
-     * @param data raw data
+     * @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) {
         field_1_option_flag             = in.readShort();

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

@@ -45,10 +45,7 @@ public class NumberFormatIndexRecord
     /**
      * Constructs a NumberFormatIndex record and sets its fields appropriately.
      *
-     * @param id    id must be 0x104e or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public NumberFormatIndexRecord(RecordInputStream in)

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

@@ -54,9 +54,7 @@ public class NumberRecord
     /**
      * Constructs a Number record and sets its fields appropriately.
      *
-     * @param id     id must be 0x203 or an exception will be throw upon validation
+     * @param in the RecordInputstream to read the record from
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public NumberRecord(RecordInputStream in)
@@ -65,11 +63,7 @@ public class NumberRecord
     }
 
     /**
-     * called by the constructor, should set class level fields.  Should throw
+     * @param in the RecordInputstream to read the record from
-     * runtime exception for bad/icomplete data.
-     *
-     * @param data raw data
-     * @param size size of data
      */
 
     protected void fillFields(RecordInputStream in)

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

@@ -52,10 +52,7 @@ public class ObjRecord
     /**
      * Constructs a OBJ record and sets its fields appropriately.
      *
-     * @param id    id must be 0x5D or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public ObjRecord(RecordInputStream in)

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

@@ -52,10 +52,7 @@ public class ObjectLinkRecord
     /**
      * Constructs a ObjectLink record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1027 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public ObjectLinkRecord(RecordInputStream in)

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

@@ -50,10 +50,7 @@ public class PaletteRecord
 
     /**
      * Constructs a PaletteRecord record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x92 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PaletteRecord(RecordInputStream in)

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

@@ -53,10 +53,7 @@ public class PaneRecord
     /**
      * Constructs a Pane record and sets its fields appropriately.
      *
-     * @param id    id must be 0x41 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public PaneRecord(RecordInputStream in)

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

@@ -41,10 +41,7 @@ public class PasswordRecord
 
     /**
      * Constructs a Password record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x13 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PasswordRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class PasswordRev4Record
 
     /**
      * Constructs a PasswordRev4 (PROT4REVPASS) record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x1bc or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PasswordRev4Record(RecordInputStream in)

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

@@ -44,10 +44,7 @@ public class PlotAreaRecord
     /**
      * Constructs a PlotArea record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1035 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public PlotAreaRecord(RecordInputStream in)

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

@@ -46,10 +46,7 @@ public class PlotGrowthRecord
     /**
      * Constructs a PlotGrowth record and sets its fields appropriately.
      *
-     * @param id    id must be 0x1064 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public PlotGrowthRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class PrecisionRecord
 
     /**
      * Constructs a Precision record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xe or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PrecisionRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class PrintGridlinesRecord
 
     /**
      * Constructs a PrintGridlines record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x2b or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PrintGridlinesRecord(RecordInputStream in)

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

@@ -43,10 +43,7 @@ public class PrintHeadersRecord
 
     /**
      * Constructs a PrintHeaders record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x2a or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PrintHeadersRecord(RecordInputStream in)

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

@@ -73,10 +73,7 @@ public class PrintSetupRecord
 
     /**
      * Constructs a PrintSetup (SETUP) record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xa1 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public PrintSetupRecord(RecordInputStream in)

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

@@ -43,10 +43,7 @@ public class ProtectRecord
 
     /**
      * Constructs a Protect record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id id must be 0x12 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)
      */
 
     public ProtectRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class ProtectionRev4Record
 
     /**
      * Constructs a ProtectionRev4 record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x1af or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public ProtectionRev4Record(RecordInputStream in)

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

@@ -60,10 +60,7 @@ public class RKRecord
 
     /**
      * Constructs a RK record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x27e or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public RKRecord(RecordInputStream in)

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

@@ -51,10 +51,7 @@ public class RecalcIdRecord
 
     /**
      * Constructs a RECALCID record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x13d or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public RecalcIdRecord(RecordInputStream in)

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

@@ -45,11 +45,8 @@ public abstract class Record
     /**
      * Constructor Record
      *
-     * @param id record id
+     * @param in the RecordInputstream to read the record from
-     * @param size record size
-     * @param data raw data
      */
-
     public Record(RecordInputStream in)
     {
         validateSid(in.getSid());

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

@@ -44,10 +44,7 @@ public class RefModeRecord
 
     /**
      * Constructs a RefMode record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0xf or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public RefModeRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class RefreshAllRecord
 
     /**
      * Constructs a RefreshAll record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x187 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public RefreshAllRecord(RecordInputStream in)

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

@@ -68,10 +68,7 @@ public class RowRecord
 
     /**
      * Constructs a Row record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x208 or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public RowRecord(RecordInputStream in)

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

@@ -46,10 +46,7 @@ public class SCLRecord
     /**
      * Constructs a SCL record and sets its fields appropriately.
      *
-     * @param id    id must be 0xa0 or an exception
+     * @param in the RecordInputstream to read the record from
-     *              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)
      */
 
     public SCLRecord(RecordInputStream in)

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

@@ -42,10 +42,7 @@ public class SaveRecalcRecord
 
     /**
      * Constructs an SaveRecalc record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x5f or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public SaveRecalcRecord(RecordInputStream in)

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

@@ -83,10 +83,7 @@ public class SelectionRecord
 
     /**
      * Constructs a Selection record and sets its fields appropriately.
-     *
+     * @param in the RecordInputstream to read the record from
-     * @param id     id must be 0x1d or an exception will be throw upon validation
-     * @param size  the size of the data area of the record
-     * @param data  data of the record (should not contain sid/len)
      */
 
     public SelectionRecord(RecordInputStream in)