]> source.dussan.org Git - poi.git/commitdiff
reorganized TOC, removed obsolete pages
authorYegor Kozlov <yegor@apache.org>
Fri, 6 Nov 2009 00:00:35 +0000 (00:00 +0000)
committerYegor Kozlov <yegor@apache.org>
Fri, 6 Nov 2009 00:00:35 +0000 (00:00 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@833248 13f79535-47bb-0310-9956-ffa450edef68

src/documentation/content/xdocs/book.xml
src/documentation/content/xdocs/casestudies.xml
src/documentation/content/xdocs/download.xml [new file with mode: 0755]
src/documentation/content/xdocs/index.xml
src/documentation/content/xdocs/status.xml
src/documentation/content/xdocs/subversion.xml

index ec3206526c4be765fcb720beeaa1ff4a52576453..37d664d29a7a5e0c91f2876aa659cb7c74a38f42 100644 (file)
     xmlns:xlink="http://www.w3.org/1999/xlink">
 
     <menu label="Apache POI">
-        <menu-item label="TOP" href="index.html"/>
-    </menu>
-
-    <menu label="Marketing">
-        <menu-item label="Case Studies" href="casestudies.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="Project">
+    <menu label="Modules">
         <menu-item label="Overview" href="overview.html"/>
         <menu-item label="POIFS" href="poifs/index.html"/>
         <menu-item label="HSSF+XSSF" href="spreadsheet/index.html"/>
         <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-item label="News" href="news.html"/>
-        <menu-item label="Mirrors" href="mirrors.html"/>
-        <menu-item label="Changes" href="changes.html"/>
+    <menu label="Documentation">
+        <menu-item label="Javadocs" href="ext:javadoc"/>
+        <menu-item label="Legal" href="legal.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-item label="Resolutions" href="resolutions/index.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 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="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 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>
 
 </book>
index 721f08334d077c37c6b962aa0a07c199da4a0263..6b3b4e5c9be13db9abd01102bc7488a066fe0455 100644 (file)
             <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
-                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
+                just started). 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
diff --git a/src/documentation/content/xdocs/download.xml b/src/documentation/content/xdocs/download.xml
new file mode 100755 (executable)
index 0000000..df54967
--- /dev/null
@@ -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>
index 9c7f114ea76300f55de4cb169735e5ea00dd66a5..7532599e112301d086979ee1778e7ecffaa88028 100644 (file)
       <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>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>
-      <p>
-        The release is also available from the central Maven repository
-        under Group ID "org.apache.poi" and Version "3.5-FINAL".
-      </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>See the <link href="download.html">downloads</link> page for more details.</p>
     </section>
     <section><title>Purpose</title>
       <p>
            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.
             <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>
                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
-               could use some binary crunching Java coders to chew through the complexity that characterizes Microsoft's file
-               formats and help us port new ones to a superior Java platform!
+    the documentation. Last, but not least, we could use some binary crunching Java coders to chew through the 
+    complexity that characterizes Microsoft's file 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!
index 7185c3e01d3975ca96ce7ce9359cb0503eeb558d..f30245e365dfee8721972cd0b3d85bcd2f95b570 100644 (file)
@@ -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>
index 9c79be7ff621d7aebcb160cc2fc538cbc0cc0bd3..9f703505d77cce90a2f7299a37191cc138c809bc 100644 (file)
@@ -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>