You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@poi.apache.org by bu...@apache.org on 2017/12/13 14:49:40 UTC

[Bug 61898] New: Quick Guide is getting a bit out of date

https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

            Bug ID: 61898
           Summary: Quick Guide is getting a bit out of date
           Product: POI
           Version: 3.17-FINAL
          Hardware: PC
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HSSF
          Assignee: dev@poi.apache.org
          Reporter: jmarkmurphy@apache.org
  Target Milestone: ---

It has come to my attention that the Quick Guide for HSSF/XSSF is getting a bit
out of date, particularly with respect to deprecations in the last several
releases. Maybe someone should go through it thoroughly and update with current
best practices/new Enums, etc.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #6 from Javen O'Neal <on...@apache.org> ---
HorizontalAlignment and VerticalAlignment: r1823922

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #12 from Dominik Stadler <do...@gmx.at> ---
Latest changes are at r1828472

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #7 from Javen O'Neal <on...@apache.org> ---
FillPattern: r1823924

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #10 from Javen O'Neal <on...@apache.org> ---
(In reply to Javen O'Neal from comment #9)
> I don't see any other CellStyle constants that were replaced with enums.
...in the latest Spreadsheet Quick Guide. So the Quick Guide is up-to-date with
respect to enums.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #4 from Nick Burch <ap...@gagravarr.org> ---
For Apache Tika, all the examples on the website are pulled in from java
programs stored in the examples area, which area unit tested. It wouldn't be
too much work to do something similar, but likely would need some custom Forest
plugin.

Otherwise, some bits of the howto are also available in the POI examples area,
eg src/org/apache/poi/xssf/eventusermodel/examples/FromHowTo.java, maybe we
could look to do that more?

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

Javen O'Neal <on...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Blocks|                            |59836


Referenced Bugs:

https://bz.apache.org/bugzilla/show_bug.cgi?id=59836
[Bug 59836] Tracker: Replace primitives with enums
-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #8 from Javen O'Neal <on...@apache.org> ---
short -> int: r1823925

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #3 from Javen O'Neal <on...@apache.org> ---
BorderStyle: r1818054

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #9 from Javen O'Neal <on...@apache.org> ---
republished site: r1823926.

I don't see any other CellStyle constants that were replaced with enums.

There are probably some newer POI and Java idioms (Java 8: try-with-resources)
that could be updated.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

Javen O'Neal <on...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |si3012@hotmail.com

--- Comment #5 from Javen O'Neal <on...@apache.org> ---
*** Bug 62075 has been marked as a duplicate of this bug. ***

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #1 from Javen O'Neal <on...@apache.org> ---
I'll update the enums.

Side note: If we ever want to prioritize it, we could generate our quick guide
from compiled and tested example code. Tika does this.
This would allow refactoring tools in IDE's to be able to keep the
documentation up to date with the latest deprecations.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

Javen O'Neal <on...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Version|3.17-FINAL                  |4.0-dev
          Component|HSSF                        |SS Common
           Severity|normal                      |enhancement

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

Mark Murphy <jm...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Hardware|PC                          |All
                 OS|                            |All

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

Dominik Stadler <do...@gmx.at> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--- Comment #11 from Dominik Stadler <do...@gmx.at> ---
I did some more changes, mostly simple try-with-resources. I don't think we
should put everything under strict Java 8 usage as that would make the
sample-code less easy to read, these are code-snippets anyway.

I am closing this as fixed for now as the main purpose is done, we will adjust
the guides some more as we go along anyway.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org


[Bug 61898] Quick Guide is getting a bit out of date

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=61898

--- Comment #2 from Javen O'Neal <on...@apache.org> ---
Other changes:
short -> int

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@poi.apache.org
For additional commands, e-mail: dev-help@poi.apache.org