Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 6B3E1200D15 for ; Wed, 20 Sep 2017 17:48:54 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 6A1C21609E2; Wed, 20 Sep 2017 15:48:54 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 4BC861609E6 for ; Wed, 20 Sep 2017 17:48:52 +0200 (CEST) Received: (qmail 79508 invoked by uid 500); 20 Sep 2017 15:48:51 -0000 Mailing-List: contact commits-help@poi.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@poi.apache.org Delivered-To: mailing list commits@poi.apache.org Received: (qmail 79436 invoked by uid 99); 20 Sep 2017 15:48:51 -0000 Received: from Unknown (HELO svn01-us-west.apache.org) (209.188.14.144) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 20 Sep 2017 15:48:51 +0000 Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id 94A033A0386 for ; Wed, 20 Sep 2017 15:48:49 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1809043 [4/12] - in /poi/site/publish: ./ apidocs/ apidocs/org/apache/poi/ apidocs/org/apache/poi/class-use/ apidocs/org/apache/poi/common/usermodel/ apidocs/org/apache/poi/common/usermodel/class-use/ apidocs/org/apache/poi/hslf/usermodel/... Date: Wed, 20 Sep 2017 15:48:47 -0000 To: commits@poi.apache.org From: nick@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20170920154849.94A033A0386@svn01-us-west.apache.org> archived-at: Wed, 20 Sep 2017 15:48:54 -0000 Modified: poi/site/publish/apidocs/org/apache/poi/ss/format/CellFormat.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/format/CellFormat.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/format/CellFormat.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/format/CellFormat.html Wed Sep 20 15:48:44 2017 @@ -17,7 +17,7 @@ catch(err) { } //--> -var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":9,"i6":9,"i7":10,"i8":41,"i9":41}; +var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":9,"i6":9,"i7":10,"i8":9,"i9":41}; var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -234,19 +234,16 @@ extends java.lang.Object -static int +static CellType ultimateType(Cell cell) -
Deprecated.  -
POI 3.15. This will return a CellType enum in the future
-
+
Returns the ultimate cell type, following the results of formulas.
static CellType ultimateTypeEnum(Cell cell)
Deprecated.  -
POI 3.15 beta 3 - Will be deleted when we make the CellType enum transition. See bug 59791.
+
use ultimateType instead
@@ -388,15 +385,11 @@ extends java.lang.Object
  • ultimateType

    -
    public static int ultimateType(Cell cell)
    -
    Deprecated. POI 3.15. This will return a CellType enum in the future
    +
    public static CellType ultimateType(Cell cell)
    Returns the ultimate cell type, following the results of formulas. If the cell is a CellType.FORMULA, this returns the result of - Cell.getCachedFormulaResultTypeEnum(). Otherwise this returns the - result of Cell.getCellTypeEnum(). - - Will return CellType in a future version of POI. - For forwards compatibility, do not hard-code cell type literals in your code.
    + Cell.getCachedFormulaResultType(). Otherwise this returns the + result of Cell.getCellType().
    Parameters:
    cell - The cell.
    @@ -411,13 +404,14 @@ extends java.lang.Object
    • ultimateTypeEnum

      -
      public static CellType ultimateTypeEnum(Cell cell)
      -
      Deprecated. POI 3.15 beta 3 - Will be deleted when we make the CellType enum transition. See bug 59791.
      +
      @Deprecated
      + @Removal(version="4.2")
      +public static CellType ultimateTypeEnum(Cell cell)
      +
      Deprecated. use ultimateType instead
      Returns the ultimate cell type, following the results of formulas. If the cell is a CellType.FORMULA, this returns the result of - Cell.getCachedFormulaResultTypeEnum(). Otherwise this returns the - result of Cell.getCellTypeEnum().
      + Cell.getCachedFormulaResultType(). Otherwise this returns the + result of Cell.getCellType().
      Parameters:
      cell - The cell.
      Modified: poi/site/publish/apidocs/org/apache/poi/ss/formula/BaseFormulaEvaluator.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/formula/BaseFormulaEvaluator.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/formula/BaseFormulaEvaluator.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/formula/BaseFormulaEvaluator.html Wed Sep 20 15:48:44 2017 @@ -17,7 +17,7 @@ catch(err) { } //--> -var methods = {"i0":10,"i1":10,"i2":6,"i3":10,"i4":9,"i5":9,"i6":42,"i7":10,"i8":6,"i9":10,"i10":9,"i11":10,"i12":10,"i13":10,"i14":9,"i15":10}; +var methods = {"i0":10,"i1":10,"i2":6,"i3":10,"i4":9,"i5":9,"i6":10,"i7":42,"i8":6,"i9":10,"i10":9,"i11":10,"i12":10,"i13":10,"i14":9,"i15":10}; var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -213,18 +213,18 @@ implements FormulaEvaluator evaluator)  -int +CellType evaluateFormulaCell(Cell cell) -
      Deprecated.  -
      3.15. Will return a CellType enum in the future.
      -
      +
      If cell contains formula, it evaluates the formula, + and saves the result of the formula.
      CellType evaluateFormulaCellEnum(Cell cell) -
      If cell contains formula, it evaluates the formula, - and saves the result of the formula.
      +
      Deprecated.  +
      use evaluateFormulaCell(cell) instead
      +
      @@ -448,19 +448,19 @@ implements Cell is returned to allow chained calls like:
        int evaluatedCellType = evaluator.evaluateInCell(cell).getCellType();
        
      Be aware that your cell value will be changed to hold the result of the formula. If you simply want the formula - value computed for you, use evaluateFormulaCellEnum(Cell)} + value computed for you, use evaluateFormulaCell(Cell)}
      Specified by:
      evaluateInCell in interface FormulaEvaluator
      Parameters:
      -
      cell -
      +
      cell - The Cell to evaluate and modify.
      Returns:
      the cell that was passed in, allowing for chained calls
      @@ -481,26 +481,29 @@ implements
    • evaluateFormulaCell

      -
      public int evaluateFormulaCell(Cell cell)
      -
      Deprecated. 3.15. Will return a CellType enum in the future.
      -
      If cell contains formula, it evaluates the formula, and saves the result of the formula. The - cell remains as a formula cell. If the cell does not contain formula, this method returns -1 - and leaves the cell unchanged. - - Note that the type of the formula result is returned, so you know what kind of - cached formula result is also stored with the formula. +
      public CellType evaluateFormulaCell(Cell cell)
      +
      If cell contains formula, it evaluates the formula, + and saves the result of the formula. The cell + remains as a formula cell. + Else if cell does not contain formula, this method leaves + the cell unchanged. + Note that the type of the formula result is returned, + so you know what kind of value is also stored with + the formula.
      - int evaluatedCellType = evaluator.evaluateFormulaCell(cell);
      + CellType evaluatedCellType = evaluator.evaluateFormulaCell(cell);
        
      - Be aware that your cell will hold both the formula, and the result. If you want the cell - replaced with the result of the formula, use evaluateInCell(org.apache.poi.ss.usermodel.Cell)
      + Be aware that your cell will hold both the formula, + and the result. If you want the cell replaced with + the result of the formula, use evaluate(org.apache.poi.ss.usermodel.Cell) }
      Specified by:
      evaluateFormulaCell in interface FormulaEvaluator
      Parameters:
      cell - The cell to evaluate
      Returns:
      -
      -1 for non-formula cells, or the type of the formula result
      +
      The type of the formula result (the cell's type remains as CellType.FORMULA however) + If cell is not a formula cell, returns CellType._NONE rather than throwing an exception.
    @@ -510,7 +513,10 @@ implements
  • evaluateFormulaCellEnum

    -
    public CellType evaluateFormulaCellEnum(Cell cell)
    +
    @Deprecated
    + @Removal(version="4.2")
    +public CellType evaluateFormulaCellEnum(Cell cell)
    +
    Deprecated. use evaluateFormulaCell(cell) instead
    If cell contains formula, it evaluates the formula, and saves the result of the formula. The cell remains as a formula cell. @@ -520,7 +526,7 @@ implements getBooleanCellValue()  -int -getCachedFormulaResultType() -
    Deprecated.  -
    3.15. Will return a CellType enum in the future.
    -
    - +CellType +getCachedFormulaResultType()  CellType @@ -153,19 +149,14 @@ var activeTableTab = "activeTableTab"; -int -getCellType() -
    Deprecated.  -
    3.15. Will return a CellType enum in the future.
    -
    - +CellType +getCellType()  CellType getCellTypeEnum()
    Deprecated.  -
    POI 3.15 beta 3. - Will be deleted when we make the CellType enum transition. See bug 59791.
    +
    POI 3.15 beta 3.
    @@ -263,14 +254,7 @@ var activeTableTab = "activeTableTab";
    • getCellType

      -
      int getCellType()
      -
      Deprecated. 3.15. Will return a CellType enum in the future.
      -
      Will return CellType in a future version of POI. - For forwards compatibility, do not hard-code cell type literals in your code.
      -
      -
      Returns:
      -
      cell type
      -
      +
      CellType getCellType()
    @@ -279,9 +263,10 @@ var activeTableTab = "activeTableTab";
    • getCellTypeEnum

      -
      CellType getCellTypeEnum()
      -
      Deprecated. POI 3.15 beta 3. - Will be deleted when we make the CellType enum transition. See bug 59791.
      +
      @Deprecated
      + @Removal(version="4.2")
      +CellType getCellTypeEnum()
      +
      Deprecated. POI 3.15 beta 3.
      Since:
      POI 3.15 beta 3
      @@ -348,10 +333,7 @@ var activeTableTab = "activeTableTab";
      • getCachedFormulaResultType

        -
        int getCachedFormulaResultType()
        -
        Deprecated. 3.15. Will return a CellType enum in the future.
        -
        Will return CellType in a future version of POI. - For forwards compatibility, do not hard-code cell type literals in your code.
        +
        CellType getCachedFormulaResultType()
        Returns:
        cell type of cached formula result
        @@ -364,7 +346,9 @@ var activeTableTab = "activeTableTab";
        • getCachedFormulaResultTypeEnum

          -
          CellType getCachedFormulaResultTypeEnum()
          +
          @Deprecated
          + @Removal(version="4.2")
          +CellType getCachedFormulaResultTypeEnum()
          Deprecated. POI 3.15 beta 3. Will be deleted when we make the CellType enum transition. See bug 59791.
          Modified: poi/site/publish/apidocs/org/apache/poi/ss/formula/IStabilityClassifier.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/formula/IStabilityClassifier.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/formula/IStabilityClassifier.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/formula/IStabilityClassifier.html Wed Sep 20 15:48:44 2017 @@ -129,7 +129,7 @@ var activeTableTab = "activeTableTab";
        • To retain freedom to change any cell definition at any time, an application may classify all cells as 'not final'. This freedom comes at the expense of greater memory consumption.
        • For the purpose of these classifications, setting the cached formula result of a cell (for - example in FormulaEvaluator.evaluateFormulaCellEnum(org.apache.poi.ss.usermodel.Cell)) + example in FormulaEvaluator.evaluateFormulaCell(org.apache.poi.ss.usermodel.Cell)) does not constitute changing the definition of the cell.
        • Updating cells which have been classified as 'final' will cause the evaluator to behave unpredictably (typically ignoring the update).
        • Modified: poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Cell.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Cell.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Cell.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Cell.html Wed Sep 20 15:48:44 2017 @@ -17,7 +17,7 @@ catch(err) { } //--> -var methods = {"i0":6,"i1":6,"i2":6,"i3":38,"i4":6,"i5":6,"i6":6,"i7":6,"i8":38,"i9":6,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6,"i15":6,"i16":6,"i17":6,"i18":6,"i19":6,"i20":6,"i21":6,"i22":6,"i23":6,"i24":6,"i25":6,"i26":6,"i27":6,"i28":6,"i29":38,"i30":6,"i31":6,"i32":6,"i33":6,"i34":6,"i35":6,"i36":6}; +var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":38,"i5":6,"i6":6,"i7":6,"i8":6,"i9":38,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6,"i15":6,"i16":6,"i17":6,"i18":6,"i19":6,"i20":6,"i21":6,"i22":6,"i23":6,"i24":6,"i25":6,"i26":6,"i27":6,"i28":6,"i29":6,"i30":6,"i31":6,"i32":6,"i33":6,"i34":6,"i35":6}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -74,13 +74,13 @@ var activeTableTab = "activeTableTab"; @@ -122,69 +122,6 @@ var activeTableTab = "activeTableTab";
          @@ -1261,13 +1032,13 @@ int getCachedFormulaResultType()

        • Summary: 
        • Nested | 
        • -
        • Field | 
        • +
        • Field | 
        • Constr | 
        • Method
        Modified: poi/site/publish/apidocs/org/apache/poi/ss/usermodel/CellValue.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/usermodel/CellValue.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/usermodel/CellValue.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/usermodel/CellValue.html Wed Sep 20 15:48:44 2017 @@ -17,7 +17,7 @@ catch(err) { } //--> -var methods = {"i0":10,"i1":10,"i2":42,"i3":10,"i4":9,"i5":10,"i6":10,"i7":10,"i8":10,"i9":9}; +var methods = {"i0":10,"i1":10,"i2":10,"i3":42,"i4":9,"i5":10,"i6":10,"i7":10,"i8":10,"i9":9}; var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -183,17 +183,17 @@ extends java.lang.Object getBooleanValue()  -int +CellType getCellType() -
        Deprecated.  -
        POI 3.15. Use getCellTypeEnum() instead.
        -
        +
        Return the cell type.
        CellType getCellTypeEnum() -
        Return the cell type.
        +
        Deprecated.  +
        use getCellType instead
        +
        @@ -357,15 +357,16 @@ extends java.lang.Object
        • getCellTypeEnum

          -
          @Removal(version="4.2")
          +
          @Deprecated
          + @Removal(version="4.2")
           public CellType getCellTypeEnum()
          +
          Deprecated. use getCellType instead
          Return the cell type.
          Returns:
          the cell type
          Since:
          -
          POI 3.15 - Will be renamed to getCellTypeEnum() when we make the CellType enum transition in POI 4.0. See bug 59791.
          +
          POI 3.15
        @@ -375,13 +376,8 @@ public 
      • getCellType

        -
        @Deprecated
        -public int getCellType()
        -
        -
        Return the cell type. - - Will return CellType in version 4.0 of POI. - For forwards compatibility, do not hard-code cell type literals in your code.
        +
        public CellType getCellType()
        +
        Return the cell type.
        Returns:
        the cell type
        Modified: poi/site/publish/apidocs/org/apache/poi/ss/usermodel/FormulaEvaluator.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/usermodel/FormulaEvaluator.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/usermodel/FormulaEvaluator.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/usermodel/FormulaEvaluator.html Wed Sep 20 15:48:44 2017 @@ -17,7 +17,7 @@ catch(err) { } //--> -var methods = {"i0":6,"i1":6,"i2":6,"i3":38,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6}; +var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":38,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -153,18 +153,18 @@ var activeTableTab = "activeTableTab"; -int +CellType evaluateFormulaCell(Cell cell) -
        Deprecated.  -
        3.15. Will return a CellType enum in the future
        -
        +
        If cell contains formula, it evaluates the formula, + and saves the result of the formula.
        CellType evaluateFormulaCellEnum(Cell cell) -
        If cell contains formula, it evaluates the formula, - and saves the result of the formula.
        +
        Deprecated.  +
        use evaluateFormulaCell(cell)
        +
        @@ -310,7 +310,7 @@ var activeTableTab = "activeTableTab"; original cell.
    Parameters:
    -
    cell -
    +
    cell - The Cell to evaluate
@@ -320,8 +320,7 @@ var activeTableTab = "activeTableTab";
  • evaluateFormulaCell

    -
    int evaluateFormulaCell(Cell cell)
    -
    Deprecated. 3.15. Will return a CellType enum in the future
    +
    CellType evaluateFormulaCell(Cell cell)
    If cell contains formula, it evaluates the formula, and saves the result of the formula. The cell remains as a formula cell. @@ -353,7 +352,10 @@ var activeTableTab = "activeTableTab";
    • evaluateFormulaCellEnum

      -
      CellType evaluateFormulaCellEnum(Cell cell)
      +
      @Deprecated
      + @Removal(version="4.2")
      +CellType evaluateFormulaCellEnum(Cell cell)
      +
      Deprecated. use evaluateFormulaCell(cell)
      If cell contains formula, it evaluates the formula, and saves the result of the formula. The cell remains as a formula cell. @@ -363,7 +365,7 @@ var activeTableTab = "activeTableTab"; so you know what kind of value is also stored with the formula.
      - CellType evaluatedCellType = evaluator.evaluateFormulaCellEnum(cell);
      + CellType evaluatedCellType = evaluator.evaluateFormulaCell(cell);
        
      Be aware that your cell will hold both the formula, and the result. If you want the cell replaced with @@ -398,10 +400,10 @@ var activeTableTab = "activeTableTab"; Be aware that your cell value will be changed to hold the result of the formula. If you simply want the formula - value computed for you, use evaluateFormulaCellEnum(Cell)
      + value computed for you, use evaluateFormulaCell(Cell)
    Parameters:
    -
    cell -
    +
    cell - The Cell to evaluate and modify.
Modified: poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Name.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Name.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Name.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/usermodel/Name.html Wed Sep 20 15:48:44 2017 @@ -358,7 +358,12 @@ var activeTableTab = "activeTableTab";
  • HR!$A$1:$Z$345
  • SUM(Sheet1!A1,Sheet2!B2)
  • -PMT(Interest_Rate/12,Number_of_Payments,Loan_Amount)
  • - + + + Note: Using relative values like 'A1:B1' can lead to unexpected moving of + the cell that the name points to when working with the workbook in Microsoft Excel, + usually using absolute references like '$A$1:$B$1' avoids this, see also + https://superuser.com/a/1031047/126954
    Parameters:
    formulaText - the reference for this name
    Modified: poi/site/publish/apidocs/org/apache/poi/ss/usermodel/TableStyleType.html URL: http://svn.apache.org/viewvc/poi/site/publish/apidocs/org/apache/poi/ss/usermodel/TableStyleType.html?rev=1809043&r1=1809042&r2=1809043&view=diff ============================================================================== --- poi/site/publish/apidocs/org/apache/poi/ss/usermodel/TableStyleType.html (original) +++ poi/site/publish/apidocs/org/apache/poi/ss/usermodel/TableStyleType.html Wed Sep 20 15:48:44 2017 @@ -49,7 +49,7 @@ var activeTableTab = "activeTableTab";