poi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dno...@apache.org
Subject svn commit: r1711238 - in /poi/site: publish/overview.html src/documentation/content/xdocs/overview.xml
Date Thu, 29 Oct 2015 12:39:43 GMT
Author: dnorth
Date: Thu Oct 29 12:39:42 2015
New Revision: 1711238

URL: http://svn.apache.org/viewvc?rev=1711238&view=rev
Log:
Update the overview - re-organise, drop some outdated stuff and make the ooxml schemas bit
clearer

Modified:
    poi/site/publish/overview.html
    poi/site/src/documentation/content/xdocs/overview.xml

Modified: poi/site/publish/overview.html
URL: http://svn.apache.org/viewvc/poi/site/publish/overview.html?rev=1711238&r1=1711237&r2=1711238&view=diff
==============================================================================
--- poi/site/publish/overview.html (original)
+++ poi/site/publish/overview.html Thu Oct 29 12:39:42 2015
@@ -256,14 +256,34 @@ if (VERSION > 3) {
 <h3>Apache POI Project Components</h3>
 </div>
       
+<p>The Apache POI project is the master project for developing pure
+        Java ports of file formats based on Microsoft's OLE 2 Compound
+        Document Format.  OLE 2 Compound Document Format is used by
+        Microsoft Office Documents, as well as by programs using MFC
+        property sets to serialize their document objects.
+      </p>
+      
+<p>Apache POI is also the master project for developing pure
+        Java ports of file formats based on Office Open XML (ooxml). 
+        OOXML is part of an ECMA / ISO standardisation effort. This
+        documentation is quite large, but you can normally find the bit you
+        need without too much effort!
+        <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">ECMA-376
standard is here</a>,
+        and is also under the 
+        <a href="https://msdn.microsoft.com/en-us/openspecifications/default">Microsoft
OSP</a>.
+      </p>
+    
+    
+      
 <a name="POIFS+for+OLE+2+Documents"></a>
 <div class="h4">
 <h4>POIFS for OLE 2 Documents</h4>
 </div>
         
 <p>
-	  POIFS is the oldest and most stable part of the project.  It is our port of the OLE 2
Compound Document Format to
-          pure Java.  It supports both read and write functionality.  All of our components
ultimately rely on it by
+	  POIFS is the oldest and most stable part of POI.  It is our port of the OLE 2 Compound
Document Format to
+          pure Java.  It supports both read and write functionality.  All of our components
for the binary (non-XML)
+          Microsoft Office formats ultimately rely on it by
           definition.  Please see <a href="./poifs/index.html">the POIFS project page</a>
for more information.
 	</p>
       
@@ -405,29 +425,6 @@ if (VERSION > 3) {
       
     
     
-<a name="What+is+it%3F"></a>
-<div class="h3">
-<h3>What is it?</h3>
-</div>
-      
-<p>The Apache POI project is the master project for developing pure
-        Java ports of file formats based on Microsoft's OLE 2 Compound
-        Document Format.  OLE 2 Compound Document Format is used by
-        Microsoft Office Documents, as well as by programs using MFC
-        property sets to serialize their document objects.
-      </p>
-      
-<p>Apache POI is also the master project for developing pure
-        Java ports of file formats based on Office Open XML (ooxml.) 
-        OOXML is part of an ECMA / ISO standardisation effort. This
-        documentation is quite large, but you can normally find the bit you
-        need without too much effort!
-        <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">ECMA-376
standard is here</a>,
-        and is also under the 
-        <a href="https://msdn.microsoft.com/en-us/openspecifications/default">Microsoft
OSP</a>.
-      </p>
-    
-    
 <a name="components"></a>
 <div class="h3">
 <h3>Component Map</h3>
@@ -577,8 +574,8 @@ if (VERSION > 3) {
       
 <p>
         This table maps artifacts into the jar file name. "version-yyyymmdd" is 
-        the POI version stamp. For the latest stable release it is 3.12-20150511.
-        For the latest beta release it is 3.12-beta1-20150228.
+        the POI version stamp. You can see what the latest stamp is on the
+        <a href="./download.html">downloads page</a>.
       </p>
       
 <table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -672,10 +669,9 @@ if (VERSION > 3) {
         version of the ooxml-schemas jar (ooxml-schemas-1.1.jar for POI 3.7 or 
         later, ooxml-scheams-1.0.jar for POI 3.5 and 3.6).
         The larger ooxml-schemas jar is <a href="faq.html#faq-N10025">normally</a>

-        only required for development.
-        Similar to the ooxml-schemas jar, the ooxml-security jar contains 
-        all generated classes for the encryption and signing schemas
-        and is subsetted in poi-ooxml-schemas.
+        only required for development. Similarly, the ooxml-security jar, which contains
+        all of the classes relating to encryption and signing, is normally only
+        required for development. A subset of its contents are in poi-ooxml-schemas.
       </p>
       
 <p>

Modified: poi/site/src/documentation/content/xdocs/overview.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/overview.xml?rev=1711238&r1=1711237&r2=1711238&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/overview.xml (original)
+++ poi/site/src/documentation/content/xdocs/overview.xml Thu Oct 29 12:39:42 2015
@@ -30,10 +30,28 @@
   </header>
   <body>
     <section><title>Apache POI Project Components</title>
+      <p>The Apache POI project is the master project for developing pure
+        Java ports of file formats based on Microsoft's OLE 2 Compound
+        Document Format.  OLE 2 Compound Document Format is used by
+        Microsoft Office Documents, as well as by programs using MFC
+        property sets to serialize their document objects.
+      </p>
+      <p>Apache POI is also the master project for developing pure
+        Java ports of file formats based on Office Open XML (ooxml). 
+        OOXML is part of an ECMA / ISO standardisation effort. This
+        documentation is quite large, but you can normally find the bit you
+        need without too much effort!
+        <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">ECMA-376
standard is here</link>,
+        and is also under the 
+        <link href="https://msdn.microsoft.com/en-us/openspecifications/default">Microsoft
OSP</link>.
+      </p>
+    
+    
       <section><title>POIFS for OLE 2 Documents</title>
         <p>
-	  POIFS is the oldest and most stable part of the project.  It is our port of the OLE 2
Compound Document Format to
-          pure Java.  It supports both read and write functionality.  All of our components
ultimately rely on it by
+	  POIFS is the oldest and most stable part of POI.  It is our port of the OLE 2 Compound
Document Format to
+          pure Java.  It supports both read and write functionality.  All of our components
for the binary (non-XML)
+          Microsoft Office formats ultimately rely on it by
           definition.  Please see <link href="./poifs/index.html">the POIFS project
page</link> for more information.
 	</p>
       </section>
@@ -133,23 +151,6 @@
 	</p>
       </section>
     </section>
-    <section><title>What is it?</title>
-      <p>The Apache POI project is the master project for developing pure
-        Java ports of file formats based on Microsoft's OLE 2 Compound
-        Document Format.  OLE 2 Compound Document Format is used by
-        Microsoft Office Documents, as well as by programs using MFC
-        property sets to serialize their document objects.
-      </p>
-      <p>Apache POI is also the master project for developing pure
-        Java ports of file formats based on Office Open XML (ooxml.) 
-        OOXML is part of an ECMA / ISO standardisation effort. This
-        documentation is quite large, but you can normally find the bit you
-        need without too much effort!
-        <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">ECMA-376
standard is here</link>,
-        and is also under the 
-        <link href="https://msdn.microsoft.com/en-us/openspecifications/default">Microsoft
OSP</link>.
-      </p>
-    </section>
     <section id="components"><title>Component Map</title>
       <p>
         The Apache POI distribution consists of support for many document file formats. This
support is provided
@@ -247,8 +248,8 @@
 
       <p>
         This table maps artifacts into the jar file name. "version-yyyymmdd" is 
-        the POI version stamp. For the latest stable release it is 3.12-20150511.
-        For the latest beta release it is 3.12-beta1-20150228.
+        the POI version stamp. You can see what the latest stamp is on the
+        <link href="./download.html">downloads page</link>.
       </p>
       <table>
         <tr>
@@ -311,12 +312,11 @@
       <p>
         poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller 
         version of the ooxml-schemas jar (ooxml-schemas-1.1.jar for POI 3.7 or 
-        later, ooxml-scheams-1.0.jar for POI 3.5 and 3.6).
+        later, ooxml-schemas-1.0.jar for POI 3.5 and 3.6).
         The larger ooxml-schemas jar is <link href="faq.html#faq-N10025">normally</link>

-        only required for development.
-        Similar to the ooxml-schemas jar, the ooxml-security jar contains 
-        all generated classes for the encryption and signing schemas
-        and is subsetted in poi-ooxml-schemas.
+        only required for development. Similarly, the ooxml-security jar, which contains
+        all of the classes relating to encryption and signing, is normally only
+        required for development. A subset of its contents are in poi-ooxml-schemas.
       </p>
       <p>
         The OOXML jars require a stax implementation, but now that Apache



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


Mime
View raw message