aboutsummaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorGlen Stampoultzis <glens@apache.org>2002-03-30 11:42:21 +0000
committerGlen Stampoultzis <glens@apache.org>2002-03-30 11:42:21 +0000
commit7554e22482807be0f2de618d16dfd9f25bd15ec0 (patch)
tree6ca4dbacef3f6b835d0c01ddd1e81ddfb5f7919c /src
parentbb124077b5420d4112213235a4fa72c1fff635f8 (diff)
downloadpoi-7554e22482807be0f2de618d16dfd9f25bd15ec0.tar.gz
poi-7554e22482807be0f2de618d16dfd9f25bd15ec0.zip
Documentation updates
git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@352299 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src')
-rw-r--r--src/documentation/xdocs/hssf/alternatives.xml83
-rw-r--r--src/documentation/xdocs/hssf/book.xml1
-rw-r--r--src/documentation/xdocs/hssf/diagrams.xml2
-rw-r--r--src/documentation/xdocs/hssf/how-to.xml1
-rw-r--r--src/documentation/xdocs/plan/POI10Vision.xml8
-rw-r--r--src/documentation/xdocs/plan/POI20Vision.xml27
6 files changed, 91 insertions, 31 deletions
diff --git a/src/documentation/xdocs/hssf/alternatives.xml b/src/documentation/xdocs/hssf/alternatives.xml
new file mode 100644
index 0000000000..1a422daee8
--- /dev/null
+++ b/src/documentation/xdocs/hssf/alternatives.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../dtd/document-v10.dtd">
+
+<document>
+ <header>
+ <title>HSSF</title>
+ <subtitle>Alternatives to HSSF</subtitle>
+ <authors>
+ <person name="Glen Stampoultzis" email="glens@apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <s1 title="Alternatives">
+ <p>
+ Maybe it's unwise to advertise your competitors but we believe
+ competition is good and we have the best support reading and
+ write Excel workbooks currently available.
+ </p>
+ <table>
+ <tr>
+ <td><b>Product</b></td>
+ <td><b>URL</b></td>
+ <td><b>Description</b></td>
+ </tr>
+ <tr>
+ <td>Formula One</td>
+ <td>
+ <link href="http://www.tidestone.com/">www.tidestone.com</link>
+ </td>
+ <td>An alternative to this project is to
+ buy the $10,000 Formula 1 library
+ and accept its crude api and limitations.</td>
+ </tr>
+ <tr>
+ <td>Visual Basic</td>
+ <td>
+ <link href="http://www.microsoft.com/">www.microsoft.com</link>
+ </td>
+ <td>Give up XML and write Visual Basic code on a Microsoft Windows based
+ Environment or output in Microsoft's beta and primarily undocumented
+ XML for office format.</td>
+ </tr>
+ <tr>
+ <td>JExcel</td>
+ <td>http://stareyes.homeip.net:8888</td>
+ <td>Frequently unavailable. Little currently known about it's capabilities.</td>
+ </tr>
+ <tr>
+ <td>JWorkbook</td>
+ <td>http://www.object-refinery.com/jworkbook/index.html</td>
+ <td>This effort supports Gnumeric and Excel, however the Excel part is done using POI anyway.</td>
+ </tr>
+ <tr>
+ <td>xlReader</td>
+ <td><link href="http://www.sourceforge.net/projects/xlrd">http://www.sourceforge.net/projects/xlrd</link></td>
+ <td>Provides decent support for reading Excel.</td>
+ </tr>
+ <tr>
+ <td>Excel ODBC Driver</td>
+ <td><link href="http://www.nwlink.com/~leewal/content/exceljavasample.htm">http://www.nwlink.com/~leewal/content/exceljavasample.htm</link></td>
+ <td>ODBC offers a somewhat wierd method for using Excel.</td>
+ </tr>
+ <tr>
+ <td>ExtenXLS</td>
+ <td><link href="http://www.extentech.com/products/ExtenXLS/docs/intro3.jsp">http://www.extentech.com/products/ExtenXLS/docs/intro3.jsp</link></td>
+ <td>Commercial library for reading, modifying and writing Excel spreadsheets. Not cheap but
+ certainly a lot more affordable than Formula 1. No idea as to it's quality.</td>
+ </tr>
+ <tr>
+ <td>J-Integra Java-Excel Bridge</td>
+ <td><link href="http://www.intrinsyc.com/products/bridging/jintegra.asp">http://www.intrinsyc.com/products/bridging/jintegra.asp</link></td>
+ <td>Uses DCOM to an Excel instance on a windows machine.</td>
+ </tr>
+ <tr>
+ <td>Perl &amp; C</td>
+ <td>-</td>
+ <td>There are a number of perl and C libraries, however none of them are consistent.</td>
+ </tr>
+ </table>
+ </s1>
+ </body>
+</document>
diff --git a/src/documentation/xdocs/hssf/book.xml b/src/documentation/xdocs/hssf/book.xml
index 9e31b9bff9..8d5a8bca49 100644
--- a/src/documentation/xdocs/hssf/book.xml
+++ b/src/documentation/xdocs/hssf/book.xml
@@ -14,6 +14,7 @@
<menu-item label="HOWTO" href="how-to.html"/>
<menu-item label="Use Case" href="use-case.html"/>
<menu-item label="Pictorial Docs" href="diagrams.html"/>
+ <menu-item label="Alternatives" href="alternatives.html"/>
</menu>
<menu label="Contributer's Guide">
diff --git a/src/documentation/xdocs/hssf/diagrams.xml b/src/documentation/xdocs/hssf/diagrams.xml
index c459ec27db..1589074530 100644
--- a/src/documentation/xdocs/hssf/diagrams.xml
+++ b/src/documentation/xdocs/hssf/diagrams.xml
@@ -24,7 +24,7 @@
</li>
</ul>
<p>
- Have more? Add a new "bug" to the bug database with [DOCUMENTATION]
+ Have more? Add a new &quot;bug&quot; to the bug database with [DOCUMENTATION]
prefacing the description and a link to the file on an http server
somewhere. If you don't have your own webserver, then you can email it
to (acoliver at apache dot org) provided its &lt; 5MB. Diagrams should be
diff --git a/src/documentation/xdocs/hssf/how-to.xml b/src/documentation/xdocs/hssf/how-to.xml
index 5e9aa71d5e..c11b8183dc 100644
--- a/src/documentation/xdocs/hssf/how-to.xml
+++ b/src/documentation/xdocs/hssf/how-to.xml
@@ -6,6 +6,7 @@
<title>The New Halloween Document</title>
<authors>
<person email="acoliver2@users.sourceforge.net" name="Andrew C. Oliver" id="AO"/>
+ <person email="glens@apache.org" name="Glen Stampoultzis" id="GJS"/>
</authors>
</header>
<body>
diff --git a/src/documentation/xdocs/plan/POI10Vision.xml b/src/documentation/xdocs/plan/POI10Vision.xml
index c49d7b39a5..ed22d59ed2 100644
--- a/src/documentation/xdocs/plan/POI10Vision.xml
+++ b/src/documentation/xdocs/plan/POI10Vision.xml
@@ -159,12 +159,8 @@
</s2>
<s2 title="2.4. Alternatives and Competition">
<p>
- The alternative to this project is to
- buy the $10,000 Formula 1 library (<link href="http://www.tidestone.com/">www.tidestone.com</link>)
- and accept its crude api and limitations. As a second alternative,
- give up XML and write Visual Basic code on a Microsoft Windows based
- Environment or output in Microsoft's beta and primarily undocumented
- XML for office format.
+ Originally there weren't any decent <link href="../hssf/alternatives.html">alternatives</link> for reading or writing
+ to Excel. This has changed somewhat.
</p>
</s2>
</s1>
diff --git a/src/documentation/xdocs/plan/POI20Vision.xml b/src/documentation/xdocs/plan/POI20Vision.xml
index 94e7065c12..59a7c25ae3 100644
--- a/src/documentation/xdocs/plan/POI20Vision.xml
+++ b/src/documentation/xdocs/plan/POI20Vision.xml
@@ -216,30 +216,9 @@
</s2>
<s2 title="2.4. Alternatives and Competition">
<p>
- Alternatives to using HSSF to manipulate Excel files include:
- </p>
- <ol>
- <li>Buy the $10,000 Formula 1 library
- (<link href="http://www.f1j.com/">www.tidestone.com</link>)
- now owned by Actuate and accept its crude api and limitations.
- </li>
- <li>Give up XML, Java, and operating system independence, and
- write Visual Basic code in a Microsoft Windows based environment
- </li>
- <li>Try writing output in Microsoft's poorly documented XHTML
- for Office format.
- </li>
- </ol>
- <p>
- There is also a decent library for
- reading Excel documents written by Andy Khan called xlReader
- (<link href="http://www.sourceforge.net/projects/xlrd">http://www.sourceforge.net/projects/xlrd</link>).
- It does not provide write ability.
- </p>
- <p>
- There are a number of PERL and C alternatives.
- None are consistent.
- </p>
+ Originally there weren't any decent <link href="../hssf/alternatives.html">alternatives</link> for reading or writing
+ to Excel. This has changed somewhat.
+ </p>
</s2>
</s1>
<s1 title="3. Project Overview">