Update changes list, and add text extraction to the HSSF docs

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

diff --git a/src/documentation/content/xdocs/changes.xml b/src/documentation/content/xdocs/changes.xml
index e4e67bee6d2267da47d8d74435f2434ab2405eb9..69c3eb87012b1758a04e0e6886f5be4772b55ff3 100644 (file)
--- a/src/documentation/content/xdocs/changes.xml
+++ b/src/documentation/content/xdocs/changes.xml
@@ -36,6 +36,7 @@
 
                <!-- Don't forget to update status.xml too! -->
         <release version="3.0.2-FINAL" date="2007-??-??">
+            <action dev="POI-DEVELOPERS" type="add">Include an Excel text extractor, and put all existing text extractors under a common superclass</action>
             <action dev="POI-DEVELOPERS" type="add">Improvements to the LZW compression engine used by HDGF</action>
             <action dev="POI-DEVELOPERS" type="add">HSSFPicture.resize() - a handy method to reset a picture to its original width and height</action>
             <action dev="POI-DEVELOPERS" type="add">Add a getSheetIndex(HSSFSheet) method to HSSFWorkbook, and allow a HSSFSheet to get at its parent HSSFWorkbook</action>

diff --git a/src/documentation/content/xdocs/hssf/quick-guide.xml b/src/documentation/content/xdocs/hssf/quick-guide.xml
index 6c86ed2df688d1ff863c6f31e5cb63c636447031..53a176e0ba1750355fb92fcd1ac26ebed901c159 100644 (file)
--- a/src/documentation/content/xdocs/hssf/quick-guide.xml
+++ b/src/documentation/content/xdocs/hssf/quick-guide.xml
@@ -41,6 +41,7 @@
                     <li><link href="#CreateCells">How to create cells</link></li>
                     <li><link href="#CreateDateCells">How to create date cells</link></li>
                     <li><link href="#CellTypes">Working with different types of cells</link></li>
+                    <li><link href="#TextExtraction">Text Extraction</link></li>
                     <li><link href="#Alignment">Aligning cells</link></li>
                     <li><link href="#Borders">Working with borders</link></li>
                     <li><link href="#FrillsAndFills">Fills and color</link></li>
@@ -233,6 +234,24 @@
     fileOut.close();
                     </source>
                 </section>
+                <anchor id="TextExtraction"/>
+                <section><title>Text Extraction</title>
+                                       <p>For most text extraction requirements, the standard
+                                       ExcelExtractor class should provide all you need.</p>
+                                       <source>
+       InputStream inp = new FileInputStream("workbook.xls");
+    HSSFWorkbook wb = new HSSFWorkbook(new POIFSFileSystem(inp));
+       ExcelExtractor extractor = new ExcelExtractor(wb);
+
+       extractor.setFormulasNotResults(true);
+       extractor.setIncludeSheetNames(false);
+       String text = extractor.getText();
+                                       </source>
+                                       <p>For very fancy text extraction, XLS to CSV etc, 
+                                       take a look at
+                                       <em>/src/scratchpad/examples/src/org/apache/poi/hssf/eventusermodel/examples/XLS2CSVmra.java</em>
+                                       </p>
+                </section>
                 <anchor id="FillsAndFrills"/>
                 <section><title>Fills and colors</title>
                     <source>

diff --git a/src/documentation/content/xdocs/status.xml b/src/documentation/content/xdocs/status.xml
index 92050159aa037e505883b6c6ef28201b196380a9..22be5a09fb97dc9bb80c38e66766e747f19f7db3 100644 (file)
--- a/src/documentation/content/xdocs/status.xml
+++ b/src/documentation/content/xdocs/status.xml
@@ -33,6 +33,7 @@
        <!-- Don't forget to update changes.xml too! -->
     <changes>
         <release version="3.0.2-FINAL" date="2007-??-??">
+            <action dev="POI-DEVELOPERS" type="add">Include an Excel text extractor, and put all existing text extractors under a common superclass</action>
             <action dev="POI-DEVELOPERS" type="add">Improvements to the LZW compression engine used by HDGF</action>
             <action dev="POI-DEVELOPERS" type="add">HSSFPicture.resize() - a handy method to reset a picture to its original width and height</action>
             <action dev="POI-DEVELOPERS" type="add">Add a getSheetIndex(HSSFSheet) method to HSSFWorkbook, and allow a HSSFSheet to get at its parent HSSFWorkbook</action>