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

22 files changed:
src/java/org/apache/poi/hssf/model/FormulaParser.java
src/java/org/apache/poi/hssf/model/Sheet.java
src/java/org/apache/poi/hssf/model/SimpleFilledShape.java
src/java/org/apache/poi/hssf/model/TextboxShape.java
src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
src/scratchpad/src/org/apache/poi/hdgf/chunks/ChunkFactory.java
src/scratchpad/src/org/apache/poi/hslf/model/TextRun.java
src/scratchpad/src/org/apache/poi/hslf/record/FontCollection.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/eval/AreaEval.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/eval/RefEval.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/eval/StringOperationEval.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/eval/ValueEvalToNumericXlator.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/FinanceLib.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/Len.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/LogicalFunction.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/MathX.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/MultiOperandNumericFunction.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/StatsLib.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/TextFunction.java
src/scratchpad/src/org/apache/poi/hssf/record/formula/functions/XYNumericFunction.java
src/scratchpad/src/org/apache/poi/hssf/usermodel/HSSFFormulaEvaluator.java
src/testcases/org/apache/poi/util/LocalTestNode.java

index 0f5eb8b5f825393f83abc033344928db9a9c6260..ffecb6daff95652ec13c9fa1a6186ee1fc681a6d 100644 (file)
@@ -534,7 +534,6 @@ public class FormulaParser {
         /** Get a PTG for an integer from its string representation. 
          * return Int or Number Ptg based on size of input
         * @param number
-        * @return
         */
        private Ptg getNumberPtgFromString(String number) {
                try {
index 140b5c17155517354c375fd597e0ef500b886150..2899005ecb1cd28d8e8da1c4f26a659ef8b5e921 100644 (file)
@@ -2506,7 +2506,6 @@ public class Sheet implements Model
 
     /** Returns the ProtectRecord.
      * If one is not contained in the sheet, then one is created.
-     * @return
      */
     public ProtectRecord getProtect()
     {
index 0bfc8bdf2e3c8805ec861316b61a282ef6dda43d..f10e1086ad3dd0179ac010091842413a34f81952 100644 (file)
@@ -48,7 +48,6 @@ public class SimpleFilledShape
      *
      * @param hssfShape
      * @param shapeId
-     * @return
      */
     private EscherContainerRecord createSpContainer( HSSFSimpleShape hssfShape, int shapeId )
     {
index 640fe01d5bb0a6b68b6ee583cbef513ff8e9592e..4b1027809150b3ddf92fcfd60b20a7eb84cdcd82 100644 (file)
@@ -77,7 +77,6 @@ public class TextboxShape
      *
      * @param hssfShape
      * @param shapeId
-     * @return
      */
     private EscherContainerRecord createSpContainer( HSSFTextbox hssfShape, int shapeId )
     {
index 4b0a0bbcf792d7a87130a03900552b8ab2312ccb..f051790018659d8325f323cd847916f3b8e1795c 100644 (file)
@@ -343,7 +343,6 @@ public class HSSFWorkbook
      * allow you to show the data of one sheet when another is seen "selected"
      * in the tabs (at the bottom).
      * @see org.apache.poi.hssf.usermodel.HSSFSheet#setSelected(boolean)
-     * @return
      */
     public short getSelectedTab() {
         return workbook.getWindowOne().getSelectedTab();
@@ -361,7 +360,6 @@ public class HSSFWorkbook
     /**
      * sets the first tab that is displayed in the list of tabs
      * in excel.
-     * @return
      */
     public short getDisplayedTab() {
         return workbook.getWindowOne().getDisplayedTab();
index fe0fc91a4dc02f19ffd44ed182a2586290d01000..f1f9edfc0362ab04fbac30059729f636b7c9365f 100644 (file)
@@ -102,7 +102,6 @@ public class ChunkFactory {
         * Creates the appropriate chunk at the given location.
         * @param data
         * @param offset
-        * @return
         */
        public Chunk createChunk(byte[] data, int offset) {
                // Create the header
index 7770311477090ca94fb60c1eba999cee10ed34f3..4999df758168f6342fbd26c7a4ea7b57215afa84 100644 (file)
@@ -478,7 +478,6 @@ public class TextRun
        /**
         * Fetch the rich text runs (runs of text with the same styling) that
         *  are contained within this block of text
-        * @return
         */
        public RichTextRun[] getRichTextRuns() {
                return  _rtRuns;
index a89422a1e366569d9d36da1d57b5f7082fc79d93..e4ee95657cdb2e1034a6e9f10c6c7e024d40e82a 100644 (file)
@@ -98,7 +98,6 @@ public class FontCollection extends RecordContainer {
         * Get the name of the font at the given ID, or null if there is
         *  no font at that ID.
         * @param id
-        * @return
         */
        public String getFontWithId(int id) {
                if(id >= fonts.size()) {
index d097648200553808f4d860ab4ed446307490326d..f60d63c131f50e30cd0ead767d7f1e983f469af1 100644 (file)
@@ -29,28 +29,24 @@ public interface AreaEval extends ValueEval {
     /**
      * returns the 0-based index of the first row in
      * this area.
-     * @return
      */
     public int getFirstRow();
 
     /**
      * returns the 0-based index of the last row in
      * this area.
-     * @return
      */
     public int getLastRow();
 
     /**
      * returns the 0-based index of the first col in
      * this area.
-     * @return
      */
     public short getFirstColumn();
 
     /**
      * returns the 0-based index of the last col in
      * this area.
-     * @return
      */
     public short getLastColumn();
     
@@ -58,7 +54,6 @@ public interface AreaEval extends ValueEval {
      * returns true if the Area's start and end row indexes
      * are same. This result of this method should agree
      * with getFirstRow() == getLastRow().
-     * @return
      */
     public boolean isRow();
     
@@ -66,7 +61,6 @@ public interface AreaEval extends ValueEval {
      * returns true if the Area's start and end col indexes
      * are same. This result of this method should agree
      * with getFirstColumn() == getLastColumn().
-     * @return
      */
     public boolean isColumn();
 
@@ -74,7 +68,6 @@ public interface AreaEval extends ValueEval {
      * The array of values  in this area. Although the area
      * maybe 1D (ie. isRow() or isColumn() returns true) or 2D
      * the returned array is 1D.
-     * @return
      */
     public ValueEval[] getValues();
 
@@ -86,7 +79,6 @@ public interface AreaEval extends ValueEval {
      * bre returned.
      * @param row
      * @param col
-     * @return
      */
     public ValueEval getValueAt(int row, short col);
     
@@ -96,21 +88,18 @@ public interface AreaEval extends ValueEval {
      * this area.
      * @param row
      * @param col
-     * @return
      */
     public boolean contains(int row, short col);
     
     /**
      * returns true if the specified col is in range
      * @param col
-     * @return
      */
     public boolean containsColumn(short col);
     
     /**
      * returns true if the specified row is in range
      * @param row
-     * @return
      */
     public boolean containsRow(int row);
 }
index 4cd46d36b5b8864390ab7a9899c1e26a97edfe1c..bb72adc4a05775fc9d687b414c2451a357db2cd6 100644 (file)
@@ -40,19 +40,16 @@ public interface RefEval extends ValueEval {
      * the RefEval representing
      * A1 will return as the getInnerValueEval() the
      * object of concrete type StringEval
-     * @return
      */
     public ValueEval getInnerValueEval();
 
     /**
      * returns the column index.
-     * @return
      */
     public short getColumn();
 
     /**
      * returns the row index.
-     * @return
      */
     public short getRow();
     
@@ -66,7 +63,6 @@ public interface RefEval extends ValueEval {
      * B1 has the value "test", then the RefEval
      * representing A1 will return isEvaluated()
      * equal to true.
-     * @return
      */
     public boolean isEvaluated();
 
index d8f3ea772f1ac354f2d0b7d543e42b1876d9c37d..e2a3c72a4c5ffa182230207ed44278371d3327c5 100644 (file)
@@ -34,7 +34,6 @@ public abstract class StringOperationEval implements OperationEval {
      * @param eval
      * @param srcRow
      * @param srcCol
-     * @return
      */
     protected ValueEval singleOperandEvaluate(Eval eval, int srcRow, short srcCol) {
         ValueEval retval;
index bf12b4dc56b9ad07570b13b46a4add03a7f0b723..5ffa2faeef73515f3bbe56faa6f8a59bcc49937a 100644 (file)
@@ -61,7 +61,6 @@ public class ValueEvalToNumericXlator {
      * The params can be either NumberEval, BoolEval, StringEval, or
      * RefEval
      * @param eval
-     * @return
      */
     public ValueEval attemptXlateToNumeric(ValueEval eval) {
         ValueEval retval = null;
@@ -114,7 +113,6 @@ public class ValueEvalToNumericXlator {
      * instance. If flag is set, a zero
      * valued numbereval is returned, else BlankEval.INSTANCE
      * is returned.
-     * @return
      */
     private ValueEval xlateBlankEval(int flag) {
         return ((flags & flag) > 0)
@@ -125,7 +123,6 @@ public class ValueEvalToNumericXlator {
     /**
      * uses the relevant flags to decode the supplied RefVal
      * @param eval
-     * @return
      */
     private ValueEval xlateRefEval(RefEval reval) {
         ValueEval retval = null;
@@ -177,7 +174,6 @@ public class ValueEvalToNumericXlator {
     /**
      * uses the relevant flags to decode the StringEval
      * @param eval
-     * @return
      */
     private ValueEval xlateStringEval(StringEval eval) {
         ValueEval retval = null;
@@ -224,7 +220,6 @@ public class ValueEvalToNumericXlator {
     /**
      * uses the relevant flags to decode the StringEval
      * @param eval
-     * @return
      */
     private ValueEval xlateRefStringEval(StringEval eval) {
         ValueEval retval = null;
index cd98cdb6308a6922d2ee82317dfab29a40ce8dd5..8baa49548981aa74e89d4ac46ba5f9adb9513170 100644 (file)
@@ -77,7 +77,6 @@ public final class FinanceLib {
      * @param y pmt per period
      * @param f future value
      * @param t type (true=pmt at end of period, false=pmt at begining of period)
-     * @return
      */
     public static double fv(double r, double n, double y, double p, boolean t) {
         double retval = 0;
@@ -103,7 +102,6 @@ public final class FinanceLib {
      * @param y
      * @param f
      * @param t
-     * @return
      */
     public static double pv(double r, double n, double y, double f, boolean t) {
         double retval = 0;
@@ -127,7 +125,6 @@ public final class FinanceLib {
      * value should be negative.
      * @param r
      * @param cfs cashflow amounts
-     * @return
      */
     public static double npv(double r, double[] cfs) {
         double npv = 0;
@@ -147,7 +144,6 @@ public final class FinanceLib {
      * @param p
      * @param f
      * @param t
-     * @return
      */
     public static double pmt(double r, double n, double p, double f, boolean t) {
         double retval = 0;
@@ -170,7 +166,6 @@ public final class FinanceLib {
      * @param p
      * @param f
      * @param t
-     * @return
      */
     public static double nper(double r, double y, double p, double f, boolean t) {
         double retval = 0;
index b16deaab6dc4c907818ddb80a69dc8115160b1b3..c0cb39b268369a6b9a9bc7fdbf09121cf4fc3bca 100644 (file)
@@ -121,7 +121,6 @@ public class Len extends TextFunction {
      * Note: AreaEvals are not handled, if arg is an AreaEval,
      * the returned value is ErrorEval.VALUE_INVALID
      * @param ve
-     * @return
      */
     protected ValueEval attemptXlateToText(ValueEval ve) {
         ValueEval retval;
index 01b86e19ea2e1d9970a8c50bb5174680309604a8..03756e1faf74137d4340a15f84d64c385a4a4a29 100644 (file)
@@ -32,7 +32,6 @@ public abstract class LogicalFunction implements Function {
     /**
      * recursively evaluate any RefEvals
      * @param reval
-     * @return
      */
     protected ValueEval xlateRefEval(RefEval reval) {
         ValueEval retval = (ValueEval) reval.getInnerValueEval();
index f87d8611b1f58bbd61be8c895f1b24e740801213..ec682d6f19bc439dd6f6f9644a98be4c77013b61 100644 (file)
@@ -48,7 +48,6 @@ public final class MathX {
      * <p>If n is NaN, returned value is NaN.
      * @param n
      * @param p
-     * @return
      */
     public static double round(double n, int p) {
         double retval;
@@ -83,7 +82,6 @@ public final class MathX {
      * <p>If n is NaN, returned value is NaN.
      * @param n
      * @param p
-     * @return
      */
     public static double roundUp(double n, int p) {
         double retval;
@@ -127,7 +125,6 @@ public final class MathX {
      * <p>If n is NaN, returned value is NaN.
      * @param n
      * @param p
-     * @return
      */
     public static double roundDown(double n, int p) {
         double retval;
@@ -158,7 +155,6 @@ public final class MathX {
      * <p> If d is NaN, then 1 will be returned. It is the responsibility
      * of caller to check for d isNaN if some other value is desired.
      * @param d
-     * @return
      */
     public static short sign(double d) {
         return (short) ((d == 0)
@@ -171,7 +167,6 @@ public final class MathX {
     /**
      * average of all values
      * @param values
-     * @return
      */
     public static double average(double[] values) {
         double ave = 0;
@@ -187,7 +182,6 @@ public final class MathX {
     /**
      * sum of all values
      * @param values
-     * @return
      */
     public static double sum(double[] values) {
         double sum = 0;
@@ -200,7 +194,6 @@ public final class MathX {
     /**
      * sum of squares of all values
      * @param values
-     * @return
      */
     public static double sumsq(double[] values) {
         double sumsq = 0;
@@ -214,7 +207,6 @@ public final class MathX {
     /**
      * product of all values
      * @param values
-     * @return
      */
     public static double product(double[] values) {
         double product = 0;
@@ -231,7 +223,6 @@ public final class MathX {
      * min of all values. If supplied array is zero length,
      * Double.POSITIVE_INFINITY is returned.
      * @param values
-     * @return
      */
     public static double min(double[] values) {
         double min = Double.POSITIVE_INFINITY;
@@ -245,7 +236,6 @@ public final class MathX {
      * min of all values. If supplied array is zero length,
      * Double.NEGATIVE_INFINITY is returned.
      * @param values
-     * @return
      */
     public static double max(double[] values) {
         double max = Double.NEGATIVE_INFINITY;
@@ -269,7 +259,6 @@ public final class MathX {
      * In all such cases, Double.NaN is returned.
      * @param n
      * @param s
-     * @return
      */
     public static double floor(double n, double s) {
         double f;
@@ -298,7 +287,6 @@ public final class MathX {
      * In all such cases, Double.NaN is returned.
      * @param n
      * @param s
-     * @return
      */
     public static double ceiling(double n, double s) {
         double c;
@@ -322,7 +310,6 @@ public final class MathX {
      * than Double.MAX_VALUE; Double.POSITIVE_INFINITY is returned.
      * If n < 0, Double.NaN is returned. 
      * @param n
-     * @return
      */
     public static double factorial(int n) {
         double d = 1;
@@ -358,7 +345,6 @@ public final class MathX {
      * If d == 0, result is NaN
      * @param n
      * @param d
-     * @return
      */
     public static double mod(double n, double d) {
         double result = 0;
@@ -385,7 +371,6 @@ public final class MathX {
     /**
      * inverse hyperbolic cosine
      * @param d
-     * @return
      */
     public static double acosh(double d) {
         return Math.log(Math.sqrt(Math.pow(d, 2) - 1) + d);
@@ -394,7 +379,6 @@ public final class MathX {
     /**
      * inverse hyperbolic sine
      * @param d
-     * @return
      */
     public static double asinh(double d) {
         double d2 = d*d;
@@ -404,7 +388,6 @@ public final class MathX {
     /**
      * inverse hyperbolic tangent
      * @param d
-     * @return
      */
     public static double atanh(double d) {
         return Math.log((1 + d)/(1 - d)) / 2;
@@ -413,7 +396,6 @@ public final class MathX {
     /**
      * hyperbolic cosine
      * @param d
-     * @return
      */
     public static double cosh(double d) {
         double ePowX = Math.pow(Math.E, d);
@@ -425,7 +407,6 @@ public final class MathX {
     /**
      * hyperbolic sine
      * @param d
-     * @return
      */
     public static double sinh(double d) {
         double ePowX = Math.pow(Math.E, d);
@@ -437,7 +418,6 @@ public final class MathX {
     /**
      * hyperbolic tangent
      * @param d
-     * @return
      */
     public static double tanh(double d) {
         double ePowX = Math.pow(Math.E, d);
@@ -452,7 +432,6 @@ public final class MathX {
      * all the subarrays are of equal length. If the subarrays are
      * not of equal length, the return value can be unpredictable.
      * @param arrays
-     * @return
      */
     public static double sumproduct(double[][] arrays) {
         double d = 0;
@@ -485,7 +464,6 @@ public final class MathX {
      * subarrays are not of equal length, the return value can be 
      * unpredictable.
      * @param arrays
-     * @return
      */
     public static double sumx2my2(double[] xarr, double[] yarr) {
         double d = 0;
@@ -511,7 +489,6 @@ public final class MathX {
      * subarrays are not of equal length, the return value can be 
      * unpredictable.
      * @param arrays
-     * @return
      */
     public static double sumx2py2(double[] xarr, double[] yarr) {
         double d = 0;
@@ -538,7 +515,6 @@ public final class MathX {
      * subarrays are not of equal length, the return value can be 
      * unpredictable.
      * @param arrays
-     * @return
      */
     public static double sumxmy2(double[] xarr, double[] yarr) {
         double d = 0;
@@ -565,7 +541,6 @@ public final class MathX {
      * If either of the parameters is negative, Double.NaN is returned.
      * @param n
      * @param k
-     * @return
      */
     public static double nChooseK(int n, int k) {
         double d = 1;
index 40e00d25145a5b28a3a7a9a14d580330d0baacce..2840c898836b83e3b2cf964c15362ac320370b56 100644 (file)
@@ -66,7 +66,6 @@ public abstract class MultiOperandNumericFunction extends NumericFunction {
     /**
      * Maximum number of operands accepted by this function.
      * Subclasses may override to change default value.
-     * @return
      */
     protected int getMaxNumOperands() {
         return DEFAULT_MAX_NUM_OPERANDS;
@@ -82,7 +81,6 @@ public abstract class MultiOperandNumericFunction extends NumericFunction {
      * @param operands
      * @param srcRow
      * @param srcCol
-     * @return
      */
     protected double[] getNumberArray(Eval[] operands, int srcRow, short srcCol) {
         double[] retval = new double[30];
@@ -120,7 +118,6 @@ public abstract class MultiOperandNumericFunction extends NumericFunction {
      * @param operand
      * @param srcRow
      * @param srcCol
-     * @return
      */
     protected double[] getNumberArray(Eval operand, int srcRow, short srcCol) {
         double[] retval;
@@ -184,7 +181,6 @@ public abstract class MultiOperandNumericFunction extends NumericFunction {
      * @param arr
      * @param pos
      * @param d
-     * @return
      */
     private static double[] putInArray(double[] arr, int pos, double d) {
         double[] tarr = arr;
index fbf7314eb88d4f343978bc2759d2746b78b41e06..8ebccfd9508115083532532ff33dfb695377045c 100644 (file)
@@ -35,7 +35,6 @@ public final class StatsLib {
     /**
      * returns the mean of deviations from mean.
      * @param v
-     * @return
      */
     public static double avedev(double[] v) {
         double r = 0;
@@ -66,7 +65,6 @@ public final class StatsLib {
      * is Double.NaN. Else returns the value that occurs most times
      * and if there is a tie, returns the first such value. 
      * @param v
-     * @return
      */
     public static double mode(double[] v) {
         double r = Double.NaN;
@@ -139,7 +137,6 @@ public final class StatsLib {
      * will result in return value Double.NaN
      * @param v
      * @param k
-     * @return
      */
     public static double kthLargest(double[] v, int k) {
         double r = Double.NaN;
@@ -160,7 +157,6 @@ public final class StatsLib {
      * will result in return value Double.NaN
      * @param v
      * @param k
-     * @return
      */
     public static double kthSmallest(double[] v, int k) {
         double r = Double.NaN;
index ba827b08f254b8801a1d15c971b341961f0f9c7f..9da17761275c4f521cfc5b19a0248c607c821425 100644 (file)
@@ -77,7 +77,6 @@ public abstract class TextFunction implements Function {
      * Note: AreaEvals are not handled, if arg is an AreaEval,
      * the returned value is ErrorEval.VALUE_INVALID
      * @param ve
-     * @return
      */
     protected ValueEval attemptXlateToText(ValueEval ve) {
         ValueEval retval;
index d6fda93af52c5156871b4053c7dc4c2e76d42f5a..9f5bcb102f6961fdbe13e1b24dad88fc70a53c80 100644 (file)
@@ -74,7 +74,6 @@ public abstract class XYNumericFunction extends NumericFunction {
      * @param operands
      * @param srcRow
      * @param srcCol
-     * @return
      */
     protected double[][] getNumberArray(Eval[] xops, Eval[] yops, int srcRow, short srcCol) {
         double[][] retval = new double[2][30];
index 78ddb399586626d70374fd5d0c557f98a10a1cf4..1b8074752edd8e805756ff84a2201679cca92aae 100644 (file)
@@ -171,7 +171,6 @@ public class HSSFFormulaEvaluator {
      * evaluateInCell() when the call should not modify the contents of the
      * original cell. 
      * @param cell
-     * @return
      */
     public CellValue evaluate(HSSFCell cell) {
         CellValue retval = null;
@@ -249,7 +248,6 @@ public class HSSFFormulaEvaluator {
     /**
      * Returns a CellValue wrapper around the supplied ValueEval instance.
      * @param eval
-     * @return
      */
     protected static CellValue getCellValueForEval(ValueEval eval) {
         CellValue retval = null;
@@ -287,7 +285,6 @@ public class HSSFFormulaEvaluator {
      * @param formula
      * @param sheet
      * @param workbook
-     * @return
      */
     protected static ValueEval internalEvaluate(HSSFCell srcCell, HSSFRow srcRow, HSSFSheet sheet, HSSFWorkbook workbook) {
         int srcRowNum = srcRow.getRowNum();
@@ -409,7 +406,6 @@ public class HSSFFormulaEvaluator {
      * returns the OperationEval concrete impl instance corresponding
      * to the suplied operationPtg
      * @param ptg
-     * @return
      */
     protected static Eval getOperationEvalForPtg(OperationPtg ptg) {
         Eval retval = null;
@@ -432,7 +428,6 @@ public class HSSFFormulaEvaluator {
      * passed here!
      * 
      * @param ptg
-     * @return
      */
     protected static Eval getEvalForPtg(Ptg ptg) {
         Eval retval = null;
@@ -478,7 +473,6 @@ public class HSSFFormulaEvaluator {
      * @param cell
      * @param sheet
      * @param workbook
-     * @return
      */
     protected static ValueEval getEvalForCell(HSSFCell cell, HSSFRow row, HSSFSheet sheet, HSSFWorkbook workbook) {
         ValueEval retval = BlankEval.INSTANCE;
index 07ef590816ad97ceddcfda27df33e3a8f48abcab..2f1ae62649679a8b479f915c4da942a65cdddc84 100644 (file)
@@ -77,8 +77,6 @@ class LocalTestNode
      * Method compareTo
      *
      * @param o
-     *
-     * @return
      */
 
     public int compareTo(Object o)