poi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n...@apache.org
Subject svn commit: r1589846 - in /poi/site: publish/poifs/how-to.html src/documentation/content/xdocs/poifs/how-to.xml
Date Thu, 24 Apr 2014 19:35:03 GMT
Author: nick
Date: Thu Apr 24 19:35:02 2014
New Revision: 1589846

URL: http://svn.apache.org/r1589846
Log:
Update NPOIFS docs

Modified:
    poi/site/publish/poifs/how-to.html
    poi/site/src/documentation/content/xdocs/poifs/how-to.xml

Modified: poi/site/publish/poifs/how-to.html
URL: http://svn.apache.org/viewvc/poi/site/publish/poifs/how-to.html?rev=1589846&r1=1589845&r2=1589846&view=diff
==============================================================================
--- poi/site/publish/poifs/how-to.html (original)
+++ poi/site/publish/poifs/how-to.html Thu Apr 24 19:35:02 2014
@@ -250,10 +250,12 @@ if (VERSION > 3) {
 <td colspan="1" rowspan="1">Conventional Reading (POIFSFileSystem)</td>
 	  <td colspan="1" rowspan="1">
 	      Simpler API similar to reading a conventional file system.<br>
-	      Can read documents in any order.
+	      Can read documents in any order.<br>
+         Well tested read and write support
 	  </td>
 	  <td colspan="1" rowspan="1">
-	      All files are resident in memory, whether your application needs them or not.
+	      All files are resident in memory, whether your application needs them or not.<br>
+         Writes only to OutputStreams, no in-place writing
 	  </td>
 	
 </tr>
@@ -264,12 +266,14 @@ if (VERSION > 3) {
 	  <td colspan="1" rowspan="1">
 	      Simpler API similar to reading a conventional file system.<br>
 	      Can read documents in any order.<br>
-         Lower memory than POIFSFileSystem
+         Lower memory than POIFSFileSystem<br>
+         Well tested read support<br>
+         Supports in-place writes
 	  </td>
 	  <td colspan="1" rowspan="1">
          If created from an InputStream, all files are resident in memory.
          (If created from a File, only certain key structures are)<br>
-         Currently doesn't support writing
+         Write support is quite recent, not as fully hardened as POIFSFileSystem
 	  </td>
 	
 </tr>
@@ -450,7 +454,7 @@ DocumentInputStream stream = new Documen
          budget on memory use of up to 20% of the file size when using a File,
          or up to 120% of the file size when using an InputStream.</p>
 	
-<a name="Preparation-N101C0"></a>
+<a name="Preparation-N101C8"></a>
 <div class="h2">
 <h2>Preparation</h2>
 </div>
@@ -505,7 +509,7 @@ DirectoryEntry root = fs.getRoot();
         
 <p>The event-driven API for reading documents is a little more complicated and requires
that your application know, in advance, which files it wants to read. The benefit of using
this API is that each document is in memory just long enough for your application to read
it, and documents that you never read at all are not in memory at all. When you're finished
reading the documents you wanted, the file system has no data structures associated with it
at all and can be discarded.</p>
 	
-<a name="Preparation-N101DF"></a>
+<a name="Preparation-N101E7"></a>
 <div class="h2">
 <h2>Preparation</h2>
 </div>

Modified: poi/site/src/documentation/content/xdocs/poifs/how-to.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/poifs/how-to.xml?rev=1589846&r1=1589845&r2=1589846&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/poifs/how-to.xml (original)
+++ poi/site/src/documentation/content/xdocs/poifs/how-to.xml Thu Apr 24 19:35:02 2014
@@ -87,10 +87,12 @@
 	  <td>Conventional Reading (POIFSFileSystem)</td>
 	  <td>
 	      Simpler API similar to reading a conventional file system.<br/>
-	      Can read documents in any order.
+	      Can read documents in any order.<br/>
+         Well tested read and write support
 	  </td>
 	  <td>
-	      All files are resident in memory, whether your application needs them or not.
+	      All files are resident in memory, whether your application needs them or not.<br
/>
+         Writes only to OutputStreams, no in-place writing
 	  </td>
 	</tr>
 	<tr>
@@ -98,12 +100,14 @@
 	  <td>
 	      Simpler API similar to reading a conventional file system.<br/>
 	      Can read documents in any order.<br/>
-         Lower memory than POIFSFileSystem
+         Lower memory than POIFSFileSystem<br/>
+         Well tested read support<br />
+         Supports in-place writes
 	  </td>
 	  <td>
          If created from an InputStream, all files are resident in memory.
          (If created from a File, only certain key structures are)<br/>
-         Currently doesn't support writing
+         Write support is quite recent, not as fully hardened as POIFSFileSystem
 	  </td>
 	</tr>
         <tr>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org


Mime
View raw message