reorganized TOC, removed obsolete pages

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

src/documentation/content/xdocs/book.xml

@@ -25,14 +25,13 @@
     xmlns:xlink="http://www.w3.org/1999/xlink">
 
     <menu label="Apache POI">
-        <menu-item label="TOP" href="index.html"/>
+        <menu-item label="Home" href="index.html"/>
+        <menu-item label="Download" href="download.html"/>
+        <menu-item label="FAQ" href="faq.html"/>
+        <menu-item label="History and Future" href="historyandfuture.html"/>
     </menu>
 
-    <menu label="Marketing">
+    <menu label="Modules">
-        <menu-item label="Case Studies" href="casestudies.html"/>
-    </menu>
-
-    <menu label="Project">
         <menu-item label="Overview" href="overview.html"/>
         <menu-item label="POIFS" href="poifs/index.html"/>
         <menu-item label="HSSF+XSSF" href="spreadsheet/index.html"/>
@@ -44,50 +43,34 @@
         <menu-item label="HPBF" href="hpbf/index.html"/>
         <menu-item label="OpenXML4J" href="oxml4j/index.html"/>
 		    <menu-item label="POI-Ruby" href="poi-ruby.html"/>
-        <menu-item label="POI-Utils" href="utils/index.html"/>
         <menu-item label="Text Extraction" href="text-extraction.html"/>
-        <menu-item label="Download" href="ext:download"/>
     </menu>
 
-    <menu label="Community">
+    <menu label="Documentation">
-        <menu-item label="News" href="news.html"/>
+        <menu-item label="Javadocs" href="ext:javadoc"/>
-        <menu-item label="Mirrors" href="mirrors.html"/>
+        <menu-item label="Legal" href="legal.html"/>
-        <menu-item label="Changes" href="changes.html"/>
+      <!--
         <menu-item label="To Do" href="todo.html"/>
-        <menu-item label="Get Involved" href="getinvolved/index.html"/>
-        <menu-item label="Mailing Lists" href="mailinglists.html"/>
         <menu-item label="Vision" href="plan/POI20Vision.html"/>
-        <menu-item label="History and Future" href="historyandfuture.html"/>
+      -->  
-        <menu-item label="Who We Are" href="who.html"/>
+    </menu>
+
+    <menu label="Development">
+        <menu-item label="Changes" href="changes.html"/>
+        <menu-item label="Source Repository" href="subversion.html"/>
+        <menu-item label="Mailing Lists" href="mailinglists.html"/>
+        <menu-item label="Bug Database" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI"/>
+        <menu-item label="How to Build" href="howtobuild.html"/>
         <menu-item label="Resolutions" href="resolutions/index.html"/>
+        <menu-item label="Get Involved" href="getinvolved/index.html"/>
+        <menu-item label="Who We Are" href="who.html"/>
+    </menu>
+
+    <menu label="Misc">
+        <menu-item label="Case Studies" href="casestudies.html"/>
+        <menu-item label="References" href="references/index.html"/>
+        <menu-item label="POI in the News" href="news.html"/>
         <menu-item label="Sponsors" href="http://www.apache.org/foundation/thanks.html" />
     </menu>
 
-    <menu label="Docs">
-        <menu-item label="Javadocs" href="ext:javadoc"/>
-        <menu-item label="FAQ" href="faq.html"/>
-        <menu-item label="Legal" href="legal.html"/>
-        <menu-item label="References" href="references/index.html"/>
-        <menu-item label="How to Build" href="howtobuild.html"/>
-    </menu>
-
-    <menu label="Translations">
-        <menu-item label="Index" href="trans/index.html"/>
-        <menu-item label="Guidelines" href="trans/guidelines.html"/>
-        <menu-item label="German (DE)" href="trans/de/index.html"/>
-        <menu-item label="Spanish (ES)" href="trans/es/index.html"/>
-        <menu-item label="Japanese (Web)" href="http://jakarta.terra-intl.com/poi/"/>
-        <menu-item label="Korean (Web)" href="http://jakarta.apache-korea.org/poi/"/>
-    </menu>
-
-    <menu label="Code">
-        <menu-item label="Subversion (current source code)" href="subversion.html"/>
-        <menu-item label="Top Voted Bugs" href="http://issues.apache.org/bugzilla/buglist.cgi?votes=1&amp;product=POI&amp;order=bugs.votes"/>
-        <menu-item label="Bug Database" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI"/>
-        <menu-item label="Patches" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr"/>
-        <menu-item label="Junit Test Results" href="ext:junit"/>
-        <menu-item label="Dependency Metrics" href="ext:jdepend"/>
-        <!--    <menu-item label="Checkstyle Metrics" href="http://jakarta.apache.org/poi/metrics/checkstyle/"/> -->
-    </menu>
-
 </book>

src/documentation/content/xdocs/casestudies.xml

@@ -44,10 +44,7 @@
             <title>Submitting a Case Study</title>
             <p>
                 We are actively seeking case studies for this page (after all it
-                just started).  Andrew C. Oliver (acoliver at apache dot org) has
+                just started). To submit a case study, either
-                agreed to have a few T-Shirts printed with the POI logo (once its
-                chosen) for the first
-                few best submissions.  To submit a case study, either
                 <link href="getinvolved/index.html">
                     submit a patch for this page</link> or email it to the
                 <link href="mailinglists.html">mailing list

src/documentation/content/xdocs/download.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+   ====================================================================
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd">
+
+<document>
+  <header>
+    <title>Apache POI - Download</title>
+  </header>
+
+  <body>
+    <section><title>Downloads</title>
+      <p>
+        Use the links below to download Apache POI releases from one of our mirrors. 
+        You should <link href="download.html#verify">verify the integrity</link> 
+        of the files using the signatures and checksums available from this page.
+      </p>
+      <ul>
+          <li>Latest stable release: <link href="download.html#POI-3.5-FINAL">Apache POI 3.5</link></li>
+          <li><link href="download.html#archive">Release Archive</link></li>
+      </ul>
+      <p>
+        Apache POI releases are available under the <link href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0.</link> 
+        See the NOTICE file contained in each release artifact for applicable copyright attribution notices. 
+    </p>
+    </section>
+    <section><title>28 September 2009 - POI 3.5-FINAL available</title>
+      <anchor id="POI-3.5-FINAL"/>
+      <p>The Apache POI team is pleased to announce the release of 3.5 FINAL. 
+        This release brings many improvements including support for the new OOXML formats introduced in Office 2007, such as XLSX and DOCX.
+      </p>
+      <p>A full list of changes is available in the <link href="changes.html">change log</link>. 
+        People interested should also follow the <link href="mailinglists.html">dev list</link> to track progress.</p>
+      <p>
+        The POI source release as well as the pre-built binary deployment packages are listed below. 
+        Pre-built versions of all <link href="index.html#components">POI components</link> are available in the central Maven repository
+        under Group ID "org.apache.poi" and Version "3.5-FINAL".
+      </p>
+      <section><title>Binary Distribution</title>
+      <ul>
+        <li><link href="http://www.apache.org/dyn/closer.cgi/poi/release/bin/poi-bin-3.5-FINAL-20090928.tar.gz">poi-bin-3.5-FINAL-20090928.tar.gz</link> (
+          19MB, <link href="http://www.apache.org/dist/poi/release/bin/poi-bin-3.5-FINAL-20090928.tar.gz.asc">signed</link>)
+          <br/>
+          MD5 checksum: 8cdf715caca82ef55be8de8ed0fc5a13
+        </li>
+        <li><link href="http://www.apache.org/dyn/closer.cgi/poi/release/bin/poi-bin-3.5-FINAL-20090928.zip">poi-bin-3.5-FINAL-20090928.zip</link> (
+          26MB, <link href="http://www.apache.org/dist/poi/release/bin/poi-bin-3.5-FINAL-20090928.zip.asc">signed</link>)
+          <br/>
+          MD5 checksum: a53fa84cb24c7d4750e77c2bbb2b1d8e
+        </li>
+      </ul>
+      </section>
+      <section><title>Source Distribution</title>
+      <ul>
+        <li><link href="http://www.apache.org/dyn/closer.cgi/poi/release/src/poi-src-3.5-FINAL-20090928.tar.gz">poi-src-3.5-FINAL-20090928.tar.gz</link> (
+          41MB, <link href="http://www.apache.org/dist/poi/release/src/poi-src-3.5-FINAL-20090928.tar.gz.asc">signed</link>)
+          <br/>
+          MD5 checksum: 0919fe59b96b8fb852cdcf9b6a627d61
+        </li>
+        <li><link href="http://www.apache.org/dyn/closer.cgi/poi/release/src/poi-src-3.5-FINAL-20090928.zip">poi-src-3.5-FINAL-20090928.zip</link> (
+          51MB, <link href="http://www.apache.org/dist/poi/release/src/poi-src-3.5-FINAL-20090928.zip.asc">signed</link>)
+          <br/>
+          MD5 checksum: 343a78b54d2ed36093cc0870b167b0f8
+        </li>
+      </ul>
+      </section>
+    </section>
+    <section><title>Release Archive</title>
+      <anchor id="archive"/>
+      <p>
+        Only current recommended releases are available on the main distribution site and its mirrors. 
+        Older releases are available from the 
+        <link href="http://archive.apache.org/dist/poi/">archive</link>
+        download site.      
+      </p>
+    </section>
+    <section><title>Verify</title>
+      <anchor id="verify"/>
+      <p>
+        It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures. 
+        Please read Verifying Apache HTTP Server Releases for more information on why you should verify our releases.
+      </p>
+      <p>
+        The PGP signatures can be verified using PGP or GPG. First download the KEYS file as well as the .asc signature files 
+        for the relevant release packages. Make sure you get these files from the main distribution directory, 
+        rather than from a mirror. Then verify the signatures using
+      </p>
+      <source>
+      % pgpk -a KEYS
+      % pgpv poi-X.Y.Z.jar.asc        
+      </source>  
+      <p>or</p>
+      <source>
+      % pgp -ka KEYS
+      % pgp poi-X.Y.Z.jar.asc
+      </source>
+      <p>or</p>
+      <source>
+      % gpg --import KEYS
+      % gpg --verify poi-X.Y.Z.jar.asc
+      </source>
+    </section>
+  </body>
+  <footer>
+    <legal>
+      Copyright (c) @year@ The Apache Software Foundation. All rights reserved.
+    </legal>
+  </footer>
+</document>

src/documentation/content/xdocs/index.xml

@@ -35,14 +35,9 @@
       <p>The Apache POI team is pleased to announce the release of 3.5 FINAL. 
         This release brings many improvements including support for the new OOXML formats introduced in Office 2007, such as XLSX and DOCX.
     </p>
-       <p>A full list of changes is available in the <link href="changes.html">change log</link></p>
+    <p>A full list of changes is available in the <link href="changes.html">change log</link>. 
-       <p>The source and binaries can be downloaded from your <link href="http://www.apache.org/dyn/closer.cgi/poi/release/">local mirror</link>.
+      People interested should also follow the <link href="mailinglists.html">dev list</link> to track progress.</p>
-       People interested should also follow the
+     <p>See the <link href="download.html">downloads</link> page for more details.</p>
-       <link href="mailinglists.html">dev list</link> to track progress.</p>
-      <p>
-        The release is also available from the central Maven repository
-        under Group ID "org.apache.poi" and Version "3.5-FINAL".
-      </p>
     </section>
     <section><title>Purpose</title>
       <p>
@@ -150,6 +145,7 @@
 	    information</link>.</p>
         </section>
      <section><title>Component map</title>
+       <anchor id="components"/>
        <p>
          The POI distribution consists of several JAR files. Not all of them are needed in every case. The following table
          shows the relationships between POI components and the JAR files.
@@ -159,61 +155,51 @@
             <th>Component</th>
             <th>JAR</th>
             <th>Maven artifactId</th>
-            <th>Comment</th>
           </tr>
           <tr>
             <td><link href="./poifs/index.html">POIFS</link></td>
             <td>poi-version-yyyymmdd.jar</td>
             <td>poi</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./hpsf/index.html">HPSF</link></td>
             <td>poi-version-yyyymmdd.jar</td>
             <td>poi</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./spreadsheet/index.html">HSSF</link></td>
             <td>poi-version-yyyymmdd.jar</td>
             <td>poi</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./spreadsheet/index.html">XSSF</link></td>
             <td>poi-ooxml-version-yyyymmdd.jar</td>
             <td>poi-ooxml</td>
-            <td>since 3.5-beta4</td>
           </tr>
           <tr>
             <td><link href="./slideshow/index.html">HLSF</link></td>
             <td>poi-scratchpad-version-yyyymmdd.jar</td>
             <td>poi-scratchpad</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./hwpf/index.html">HWPF</link></td>
             <td>poi-scratchpad-version-yyyymmdd.jar</td>
             <td>poi-scratchpad</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./hdgf/index.html">HDGF</link></td>
             <td>poi-scratchpad-version-yyyymmdd.jar</td>
             <td>poi-scratchpad</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./hpbf/index.html">HPBF</link></td>
             <td>poi-scratchpad-version-yyyymmdd.jar</td>
             <td>poi-scratchpad</td>
-            <td></td>
           </tr>
           <tr>
             <td><link href="./hsmf/index.html">HSMF</link></td>
             <td>poi-scratchpad-version-yyyymmdd.jar</td>
             <td>poi-scratchpad</td>
-            <td></td>
           </tr>
         </table>
      </section>
@@ -223,9 +209,8 @@
 		So you'd like to contribute to the project? Great! We need enthusiastic, hard-working, talented folks to help
 		us on the project in several areas. The first is bug reports and feature requests! The second is documentation -
 		we'll be at your every beck and call if you've got a critique or you'd like to contribute or otherwise improve
-		the documentation. We could especially use some help documenting the HSSF file format! Last, but not least, we
+    the documentation. Last, but not least, we could use some binary crunching Java coders to chew through the 
-		could use some binary crunching Java coders to chew through the complexity that characterizes Microsoft's file
+    complexity that characterizes Microsoft's file formats and help us port new ones to a superior Java platform!
-		formats and help us port new ones to a superior Java platform!
         </p>
         <p>So if you're motivated, ready, and have the time, join the mail lists and we'll be happy to help you get started on the
            project!

src/documentation/content/xdocs/status.xml

@@ -34,6 +34,7 @@
 
     <changes>
         <release version="3.6-beta1" date="2009-??-??">
+           <action dev="POI-DEVELOPERS" type="fix">48087 - avoid NPE in XSSFChartSheet  when calling methods of the superclass</action>
            <action dev="POI-DEVELOPERS" type="fix">48038 - handle reading HWPF stylesheets from non zero offsets</action>
            <action dev="POI-DEVELOPERS" type="add">When running the "compile-ooxml-xsds" ant task, also generate the source jar for the OOXML Schemas</action>
            <action dev="POI-DEVELOPERS" type="fix">45672 - improve handling by MissingRecordAwareHSSFListener of records that cover multiple cells (MulBlankRecord and MulRKRecord)</action>

src/documentation/content/xdocs/subversion.xml

@@ -21,7 +21,7 @@
 
 <document>
   <header>
-    <title>Subversion - Source Code Repository</title>
+    <title>Source Code Repository</title>
     <authors>
       <person id="NB" name="Nick Burch" email="nick@apache.org"/>
     </authors>