Obtained from: Submitted by: Reviewed by: added built doc files git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@352105 13f79535-47bb-0310-9956-ffa450edef68tags/prelogging
@@ -0,0 +1,180 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>History of Changes</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>History of Changes</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>History of Changes</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b> 1.1-dev (February 17 2002)</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<sl> | |||
<li> | |||
<icon alt="update" src="images/update.jpg"></icon> | |||
New project build. | |||
(NKB)</li> | |||
<li> | |||
<icon alt="update" src="images/update.jpg"></icon> | |||
New project documentation system based on Cocoon. | |||
(NKB)</li> | |||
</sl> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,530 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Contribution to POI</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Contribution to POI</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Contribution to POI</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Introduction</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
The POI Project is an <a href="http://www.opensource.org/">Open Source</a> | |||
volunteer project released under a very open license. | |||
This means there are many ways to contribute to the project - either | |||
with direct participation (coding, documenting, answering questions, | |||
proposing ideas, reporting bugs, suggesting bug fixes, etc. ...) or by resource | |||
donations (money, time, publicity, hardware, software, conference | |||
presentations, speeches, etc. ...). | |||
</p> | |||
<p align="justify"> | |||
To begin with, we suggest you subscribe to the | |||
<a href="mail-lists.html">POI mailing lists</a> | |||
(follow the link for information on how to subscribe and to access the mail | |||
list archives). Listen in for a while, to hear how others make contributions. | |||
</p> | |||
<p align="justify">You can get your local working copy of the | |||
<a href="http://jakarta.apache.org/site/cvsindex.html">latest and | |||
greatest code</a> (which you find in the jakarta-poi module in | |||
the CVS code repository. Review the <a href="todo.html">todo</a> list and choose a task | |||
(or perhaps you have noticed something that needs patching). Make the changes, do the testing, | |||
generate a patch, and post to the dev mailing list. (Do not worry - the process is easy and | |||
explained below.) | |||
</p> | |||
<p align="justify"> | |||
Document writers are usually the most wanted people so if | |||
you like to help but you're not familiar with the innermost technical details, don't worry: | |||
we have work for you! And we'll be very available to you for any questions! | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Help Wanted Here</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
The rest of this document is mainly about | |||
contributing new or improved code and/or documentation, but we would also be glad to have | |||
extra help in any of the following areas: | |||
</p> | |||
<ul> | |||
<li>Answering questions on the <code>users</code> mailing list - there is often a problem of | |||
having too many questioners and not enough experts to respond to all the questions.</li> | |||
<li>Testing POI (especially its less-frequently-used features) on various configurations | |||
and reporting back.</li> | |||
<li>Debugging - producing reproducible test cases and/or finding causes of bugs. Some known bugs are informally listed on | |||
<a href="todo.html">To Do</a>, and some are recorded in Bugzilla | |||
(see <a href="#procedure">explanation below</a>).</li> | |||
<li>Specifying/analyzing/designing new features - and beyond. (If you wish to get involved | |||
with this, please join the <code>general POI mailing list</code> | |||
, install and try out POI | |||
and read some of the <a href="mail-lists.html">mail archives</a>. | |||
You should have a strong "fluency" in Java and a basic understanding of | |||
the POI architecture - don't just say "it should have XYZ" without reading anything first - | |||
because chances are, someone's already thought of that feature!)</li> | |||
<li>Packaging easy-to-install packages (such as RPMs) for the myriad of possible configurations out | |||
there. (The project does not maintain anything but the basic <code>.zip</code> and | |||
<code>.tar.gz</code> packages, but anyone is welcome to build their own specific packages and | |||
announce them on the <code>general POI list</code>)</li> | |||
<li>... and there is just one other thing - don't forget to tell everyone who asks, how great POI is! ;-) | |||
The more people that know about and start to use POI, the larger the pool of | |||
potential contributors there will be. | |||
</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>CVS Usage Precis</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">An overview of how to use CVS to participate in POI development. | |||
Do not be afraid - you cannot accidently destroy the actual code repository, | |||
because you are working with a local copy as an anonymous user. | |||
You do not have the system permissions to change anything. You can only | |||
update your local repository and compare your revisions with the real | |||
repository. | |||
</p> | |||
<p align="justify"> | |||
(Further general CVS usage information is at | |||
<a href="http://www.cvshome.org/">www.cvshome.org</a> and your local | |||
<code>info cvs</code> pages or <code>man cvs</code> pages or user | |||
documentation.) | |||
</p> | |||
<p align="justify"> | |||
Let us lead by example. We will show you how to establish your local | |||
repository, how to keep it up-to-date, and how to generate the differences | |||
to create a patch. (The commands are for Linux.) | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>CVS Committer with Secure Shell access</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">After a developer has consistently provided contributions (code, | |||
documentation and discussion), then the rest of the dev community | |||
may vote to grant this developer commit access to CVS. | |||
</p> | |||
<p align="justify">You will need secure access to the repository to be able to commit | |||
patches. Here are some resources that help to get your machine configured | |||
to use the repository over SSH. | |||
</p> | |||
<ul> | |||
<li> | |||
<a href="http://cvsbook.red-bean.com/">The CVS Book</a> | |||
</li> | |||
<li> | |||
<a href="http://www.cvshome.org/">www.cvshome.org</a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/cvs/?group_id=32701"></a> | |||
- See the bottom of the page for links to tips for UNIX and Windows. | |||
Even if you are on UNIX, the Windows page will also help.</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Procedure for Raising Development Issues</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
There are two methods for discussing development and submitting patches. | |||
So that everyone can be productive, it is important to know which method | |||
is appropriate for a certain situation and how to go about it without | |||
confusion. This section explains when to use the | |||
<code>developer</code> <a href="mail-lists.html">mailing list</a> | |||
and the bug database. | |||
</p> | |||
<p align="justify"> | |||
Research your topic thoroughly before beginning to discuss a new | |||
development issue. Search and browse through the email archives - your | |||
issue may have been discussed before. Prepare your post clearly and | |||
concisely. | |||
</p> | |||
<p align="justify"> | |||
Most issues will be discovered, resolved, and then patched quickly | |||
via the <code>developer</code> mailing list. Larger issues, and ones that | |||
are not yet fully understood or are hard to solve, are destined for | |||
Bugzilla. | |||
</p> | |||
<p align="justify"> | |||
Experienced developers use Bugzilla directly, as they are very sure | |||
when they have found a bug and when not. However, less experienced users | |||
should first discuss it on the user or developer mailing list (as | |||
appropriate). Impatient people frequently enter everything into Bugzilla | |||
without caring if it is a bug in POI or their own | |||
installation/configuration mistake - please, do not do this. | |||
</p> | |||
<p align="justify"> | |||
As a rule-of-thumb, discuss an issue on the <code>developers</code> | |||
mailing list first to work out any details. | |||
After it is confirmed to be worthwhile, and you are clear about it, | |||
then submit the bug description or patch via Bug Tracking. | |||
</p> | |||
<p align="justify"> | |||
If you do not get any answer on your first attempt, post | |||
your issue again until you get a reply. (But, please, not every hour - allow a few | |||
days for the list to deal with it.) Do not be impatient - remember that | |||
the whole world is busy, not just you. Bear in mind that other countries | |||
will have holidays at different times to your country and that they are | |||
in different time zones. You might also consider re-writing your initial | |||
posting - perhaps it was not clear enough | |||
and the readers' eyes glazed over. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Contribution Notes and Tips</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
This is a collection of tips for contributing to the project in a manner | |||
that is productive for all parties. | |||
</p> | |||
<ul> | |||
<li> | |||
Every contribution is worthwhile. Even if the ensuing discussion | |||
proves it to be off-beam, then it may jog ideas for other people. | |||
</li> | |||
<li> | |||
Use sensible and concise email subject headings. Search engines, and | |||
humans trying to browse a voluminous list, will respond favorably to a | |||
descriptive title. | |||
</li> | |||
<li>Start new threads with new Subjects for new topics, rather than | |||
re-using the previous Subject line. | |||
</li> | |||
<li>Keep each topic focussed. If some new topic arises, start a new | |||
discussion. This leaves the original topic to continue un-cluttered. | |||
</li> | |||
<li>Whenever you decide to start a new topic, then start with a fresh | |||
new email message window. Do not use the "Reply to" button, | |||
because threaded mail-readers get confused (they use the | |||
<code>In-reply-to</code> header). Otherwise, your new topic will get | |||
lost in the previous thread and go un-answered. | |||
</li> | |||
<li> | |||
Prepend your email subject line with a marker when that is appropriate, | |||
e.g. <code>[Patch]</code>, <code>[Proposal]</code>, | |||
<code>[RT]</code> (Random Thought, these quickly blossom into research | |||
topics :-), <code>[STATUS]</code> (development status of a certain | |||
feature). | |||
</li> | |||
<li> | |||
When making changes to XML documentation, or any XML document for that | |||
matter, use a | |||
<a href="http://www.oasis-open.org/cover/">validating parser</a> | |||
(one that is tried and true is | |||
<a href="http://www.jclark.com/sp/">SP/nsgmls</a>). | |||
This procedure will detect errors without having to go through the whole | |||
<code>build docs</code> process to find them. Do not expect POI | |||
or the build system to detect the validation errors for you - they can | |||
do it, but that is not their purpose. (Anyway, nsgmls validation error | |||
messages are more informative.). Andy wishes it to be known he uses | |||
<a href="http://www.sourceforge.net/projects/jedit">jEdit</a>. For | |||
his XML editing. (That is when he's not hacking it in 'vi' the true editor | |||
and light of the text editing world!). | |||
</li> | |||
<li> | |||
Remember that most people are participating in development on a | |||
volunteer basis and in their "spare time". These enthusiasts will attempt | |||
to respond to issues. It may take a little while to get your answers. | |||
</li> | |||
<li> | |||
Research your topic thoroughly before beginning to discuss a new | |||
development issue. Search and browse through the email archives - your | |||
issue may have been discussed before. Do not just perceive a problem and | |||
then rush out with a question - instead, delve. | |||
</li> | |||
<li> | |||
Try to at least offer a partial solution and not just a problem statement. | |||
</li> | |||
<li> | |||
Take the time to clearly explain your issue and write a concise email | |||
message. Less confusion facilitates fast and complete resolution. | |||
</li> | |||
<li> | |||
Do not bother to send an email reply that simply says "thanks". | |||
When the issue is resolved, that is the finish - end of thread. | |||
Reduce clutter. | |||
</li> | |||
<li> | |||
You would usually do any development work against the HEAD branch of CVS. | |||
</li> | |||
<li> | |||
When sending a patch, you usually do not need to worry about which CVS | |||
branch it should be applied to. The maintainers of the repository will | |||
decide. | |||
</li> | |||
<li> | |||
If an issue starts to get bogged down in list discussion, then it may | |||
be appropriate to go into private off-list discussion with a few interested | |||
other people. Spare the list from the gory details. Report a summary back | |||
to the list to finalize the thread. | |||
</li> | |||
<li> | |||
Become familiar with the mailing lists. As you browse and search, you will | |||
see the way other people do things. Follow the leading examples. | |||
</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,223 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Frequently Asked Questions</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Frequently Asked Questions</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Frequently Asked Questions</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Questions</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<ul> | |||
<li> | |||
<jump anchor="faq-1"> | |||
What is the HSSF "eventmodel"? | |||
</jump> | |||
</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Answers</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<anchor id="faq-1"></anchor> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b> | |||
What is the HSSF "eventmodel"? | |||
</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
The HSSF eventmodel package is a new API for reading XLS files more efficiently. It does | |||
require more knowledge on the part of the user, but reduces memory consumption by more than | |||
tenfold. It is based on the AWT event model in combination with SAX. If you need read-only | |||
access to a given XLS file, this is the best way to do it. | |||
</p> | |||
<p align="justify"> | |||
Soon, very soon. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,91 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>HDF</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Navigation</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="../index.html"><font size="-1">Main</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>HDF</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>HDF</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Overview</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">HDF will be the name of OUR port of the Microsoft Word 97(-2002) file format to | |||
pure Java.</p> | |||
<p align="justify">HDF is still in early development. If you want to help us, you can | |||
follow development on the poi-dev mailing list.</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,284 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title></title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Brief Project History</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">The POI project was dreamed up back around April 2001, when | |||
Andy Oliver landed a short term contract to do Java-based | |||
reporting to Excel. He'd done this project a few times before | |||
and knew right where to look for the tools he needed. | |||
Ironically, the API he used to use had skyrocketed from around | |||
$300 ($US) to around $10K ($US). He figured it would take two | |||
people around six months to write an Excel port so he | |||
recommended the client fork out the $10K. | |||
</p> | |||
<p align="justify">Around June 2001, Andy started thinking how great it would | |||
be to have an open source Java tool to do this and, while he | |||
had some spare time, he started on the project and learned | |||
about OLE 2 Compound Document Format. After hitting some real | |||
stumpers he realized he'd need help. He posted a message to | |||
his local Java User's Group (JUG) and asked if anyone else | |||
would be interested. He lucked out and the most talented Java | |||
programmer he'd ever met, Marc Johnson, joined the project. He | |||
ran rings around Andy at porting OLE 2 CDF and rewrote his | |||
skeletal code into a more sophisticated library. It took Marc | |||
a few iterations to get something they were happy with. | |||
</p> | |||
<p align="justify">While Marc worked on that, Andy ported XLS to Java, based | |||
on Marc's library. Several users wrote in asking to read XLS | |||
(not just write as had originally been planned) and one user | |||
had special requests for a different use for POIFS. Before | |||
long, the project scope had tripled. POI 1.0 was released a | |||
month later than planned, but with far more features. Marc | |||
quickly wrote the serializer framework and HSSF Serializer in | |||
record time and Andy banged out more documentation and worked | |||
on making people aware of the project | |||
</p> | |||
<p align="justify"> Shortly before the release, POI was fortunate to come into | |||
contact with Nicola -Ken- Barrozzi who gave them samples for | |||
the HSSF Serializer and help uncover its unfortunate bugs | |||
(which were promptly fixed). More recently, Ken ported most | |||
of the POI project documentation to XML from Andy's crappy | |||
HTML docs he wrote with Star Office. | |||
</p> | |||
<p align="justify"> Around the same time as the release, Glen Stampoultzis | |||
joined the project. Glen was ticked off at Andy's flippant attitude | |||
towards adding graphing to HSSF. Glen got so ticked off he decided to | |||
grab a hammer and do it himself. Glen has already become an integral | |||
part of the POI development community; his contributions to HSSF have | |||
already started making waves. | |||
</p> | |||
<p align="justify">Somewhere in there we decided to finally submit the project | |||
to <a href="http://xml.apache.org/cocoon">The Apache | |||
Cocoon Project</a>, only to discover the project had | |||
outgrown fitting nicely into just Cocoon long ago. | |||
Furthermore, Andy started eyeing other projects he'd like to | |||
see POI functionality added to. So it was decided to donate | |||
the Serializers and Generators to Cocoon, other POI | |||
integration components to other projects, and the POI APIs | |||
would become part of Jakarta. It was a bumpy road but it | |||
looks like everything turned out since you're reading this! | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>What's next for POI</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">First we'll tackle this from a project standpoint: Well, we | |||
made an offer to Microsoft and Actuate (tongue in cheek | |||
... well mostly) that we'd quit the project and retire if | |||
they'd simply write us each a really large check. I've yet to | |||
get a phone call or email so I'm assuming they're not going to | |||
pay us to go away. | |||
</p> | |||
<p align="justify">Next, we've got some work to do here at Jakarta to finish | |||
integrating POI into the community. Furthermore, we're | |||
still transitioning the Serializer to Cocoon. | |||
</p> | |||
<p align="justify">HSSF, during the 2.0 cycle, will undergo a few | |||
optimizations. We'll also be adding new features like a full | |||
implementation of Formulas and custom text formats. We're | |||
hoping to be able to generate smaller files by adding | |||
write-support for RK, MulRK and MulBlank records. I'm also | |||
going to work on a Cocoon 2 Generator. Currently, reading is | |||
not very efficient in HSSF. This is mainly because in order to | |||
write or modify, one needs to be able to update upstream | |||
pointers to downstream data. To do this you have to have | |||
everything between in memory. A Generator would allow SAX | |||
events to be processed instead. (This will be based on the low | |||
level structures). One of the great things about this is that, | |||
you'll not only have a more efficient way to read the file, | |||
you'll have a great way to use spreadsheets as XML data | |||
sources. | |||
</p> | |||
<p align="justify">The HSSF Serializer, will further separate into a general | |||
framework for creating serializers for other formats and the | |||
HSSF Serializer specific implementation. (This is largely | |||
already true). We'll also be adding support for features | |||
already supported by HSSF (styles, fonts, text formats). We're | |||
hoping to add support for formulas during this cycle. | |||
</p> | |||
<p align="justify">We're beginning to expand our scope yet again. If we could | |||
do all of this for XLS files, what about Doc files or PPT | |||
files? We're thinking that our next component (HDF - Horrible | |||
Document Format) should follow the same pattern. We're hoping | |||
that new blood will join the team and allow us to tackle this | |||
even faster (in part because POIFS is already finished). But | |||
maybe what we need most is you! </p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,132 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>HSSF</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Navigation</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="../index.html"><font size="-1">Main</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">HSSF</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="how-to.html"><font size="-1">HOWTO</font></a> | |||
</li> | |||
<li> | |||
<a href="use-case.html"><font size="-1">Use Case</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>HSSF</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>HSSF</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Overview</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">HSSF is the POI Project's pure Java implementation of the Excel '97(-2002) file format.</p> | |||
<p align="justify">HSSF provides a way to read spreadsheets create, modify, read and write XLS spreadsheets | |||
It provides: | |||
</p> | |||
<ul> | |||
<li>low level structures for those with special needs</li> | |||
<li>an eventmodel api for efficient read-only access</li> | |||
<li>a full usermodel api for creating, reading and modifying XLS files</li> | |||
</ul> | |||
<p align="justify"> | |||
Truth be told there is probably a better way to generate your spreadsheet | |||
generation (yet you'll still be using HSSF indirectly). At the time of | |||
this writing we're in the process of moving the HSSF Serializer over to | |||
the <a href="http://xml.apache.org/cocoon">Apache Cocoon | |||
Project</a>. With Cocoon you can serialize any XML datasource (of | |||
which might be a ESQL page outputting in SQL for instance) by simply | |||
applying the stylesheet and designating the serializer. | |||
</p> | |||
<p align="justify"> | |||
If you're merely reading spreadsheet data, then use the eventmodel api | |||
in the org.apache.poi.hssf.eventmodel package. | |||
</p> | |||
<p align="justify"> | |||
If you're modifying spreadsheet data then use the usermodel api. You | |||
can also generate spreadsheets this way, but using Cocoon (which will do | |||
it this way indirectly) is the best way...we promise. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,480 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>HSSF Use Cases</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Navigation</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="../index.html"><font size="-1">Main</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">HSSF</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="how-to.html"><font size="-1">HOWTO</font></a> | |||
</li> | |||
<li> | |||
<a href="use-case.html"><font size="-1">Use Case</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>HSSF Use Cases</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>HSSF Use Cases</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>HSSF Use Cases</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Use Case 1: Read existing HSSF</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>Primary Actor:</em> HSSF client</p> | |||
<p align="justify"> | |||
<em>Scope:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Level:</em> Summary</p> | |||
<p align="justify"> | |||
<em>Stakeholders and Interests:</em> | |||
</p> | |||
<ul> | |||
<li>HSSF client- wants to read content | |||
of HSSF file</li> | |||
<li>HSSF - understands HSSF file</li> | |||
<li>POIFS - understands underlying POI | |||
file system</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Precondition:</em> None</p> | |||
<p align="justify"> | |||
<em>Minimal Guarantee:</em> None</p> | |||
<p align="justify"> | |||
<em>Main Success Guarantee:</em> | |||
</p> | |||
<ol> | |||
<li>HSSF client requests HSSF to read | |||
a HSSF file, providing an InputStream | |||
containing HSSF file in question.</li> | |||
<li>HSSF requests POIFS to read the HSSF | |||
file, passing the InputStream | |||
object to POIFS (POIFS use case 1, read existing file system)</li> | |||
<li>HSSF reads the "Workbook" | |||
file (use case 4, read workbook entry)</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>Extensions:</em> | |||
</p> | |||
<p align="justify">2a. Exceptions | |||
thrown by POIFS will be passed on to the HSSF client.</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Use Case 2: Write HSSF file</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>Primary Actor:</em> HSSF client</p> | |||
<p align="justify"> | |||
<em>Scope:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Level:</em> Summary</p> | |||
<p align="justify"> | |||
<em>Stakeholders and Interests:</em> | |||
</p> | |||
<ul> | |||
<li>HSSF client- wants to write file | |||
out.</li> | |||
<li>HSSF - knows how to write file | |||
out.</li> | |||
<li>POIFS - knows how to write file | |||
system out.</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Precondition:</em> | |||
</p> | |||
<ul> | |||
<li>File has been | |||
read (use case 1, read existing HSSF file) and subsequently modified | |||
or file has been created (use case 3, create HSSF file)</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Minimal Guarantee:</em> None</p> | |||
<p align="justify"> | |||
<em>Main Success Guarantee:</em> | |||
</p> | |||
<ol> | |||
<li>HSSF client | |||
provides an OutputStream to | |||
write the file to.</li> | |||
<li>HSSF writes | |||
the "Workbook" to its associated POIFS file system (use case | |||
5, write workbook entry)</li> | |||
<li>HSSF | |||
requests POIFS to write its file system out, using the OutputStream | |||
obtained from the HSSF client (POIFS use case 2, write file system).</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>Extensions:</em> | |||
</p> | |||
<p align="justify">3a. Exceptions | |||
from POIFS are passed to the HSSF client.</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Use Case 3:Create HSSF file</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>Primary Actor:</em> HSSF client</p> | |||
<p align="justify"> | |||
<em>Scope:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Level:</em> Summary</p> | |||
<p align="justify"> | |||
<em>Stakeholders and Interests:</em> | |||
</p> | |||
<ul> | |||
<li>HSSF client- wants to create a new | |||
file.</li> | |||
<li>HSSF - knows how to create a new | |||
file.</li> | |||
<li>POIFS - knows how to creat a new | |||
file system.</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Precondition:</em> | |||
</p> | |||
<p align="justify"> | |||
<em>Minimal Guarantee:</em> None</p> | |||
<p align="justify"> | |||
<em>Main Success Guarantee:</em> | |||
</p> | |||
<ol> | |||
<li>HSSF requests | |||
POIFS to create a new file system (POIFS use case 3, create new file | |||
system)</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>Extensions:</em> | |||
None</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Use Case 4: Read workbook entry</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>Primary Actor:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Scope:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Level:</em> Summary</p> | |||
<p align="justify"> | |||
<em>Stakeholders and Interests:</em> | |||
</p> | |||
<ul> | |||
<li>HSSF - knows how to read the | |||
workbook entry</li> | |||
<li>POIFS - knows how to manage the file | |||
system.</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Precondition:</em> | |||
</p> | |||
<ul> | |||
<li>The file | |||
system has been read (use case 1, read existing HSSF file) or has | |||
been created and written to (use case 3, create HSSF file system; | |||
use case 5, write workbook entry).</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Minimal | |||
Guarantee:</em> None</p> | |||
<p align="justify"> | |||
<em>Main Success Guarantee:</em> | |||
</p> | |||
<ol> | |||
<li> | |||
HSSF requests POIFS for the "Workbook" file</li> | |||
<li>POIFS returns | |||
an InputStream for the file.</li> | |||
<li>HSSF reads | |||
from the InputStream provided by POIFS</li> | |||
<li>HSSF closes | |||
the InputStream provided by POIFS</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>Extensions:</em> | |||
</p> | |||
<p align="justify">3a. Exceptions | |||
thrown by POIFS will be passed on</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Use Case 5: Write workbook entry</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>Primary Actor:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Scope:</em> HSSF</p> | |||
<p align="justify"> | |||
<em>Level:</em> Summary</p> | |||
<p align="justify"> | |||
<em>Stakeholders and Interests:</em> | |||
</p> | |||
<ul> | |||
<li>HSSF - knows how to manage the | |||
write the workbook entry.</li> | |||
<li>POIFS - knows how to manage the file | |||
system.</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Precondition:</em> | |||
</p> | |||
<ul> | |||
<li>Either an existing HSSF file has | |||
been read (use case 1, read existing HSSF file) or an HSSF file has | |||
been created (use case 3, create HSSF file).</li> | |||
</ul> | |||
<p align="justify"> | |||
<em>Minimal Guarantee:</em> None</p> | |||
<p align="justify"> | |||
<em>Main Success Guarantee:</em> | |||
</p> | |||
<ol> | |||
<li>HSSF | |||
checks the POIFS file system directory for the "Workbook" | |||
file (POIFS use case 8, read file system directory)</li> | |||
<li>If "Workbook" is in the directory, HSSF requests POIFS to | |||
replace it with the new workbook entry (POIFS use case 4, replace file | |||
in file system). Otherwise, HSSF requests POIFS to write the new | |||
workbook file, with the name "Workbook" (POIFS use case 6, | |||
write new file to file system)</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>Extensions:</em>None</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,372 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title></title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Purpose</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
The POI project consists of APIs for manipulating various file formats | |||
based upon Microsoft's OLE 2 Compound Document format using pure Java. | |||
</p> | |||
<p align="justify"> | |||
OLE 2 Compound Document Format based files include most Microsoft Office | |||
files such as XLS and DOC. | |||
</p> | |||
<p align="justify"> | |||
As a general policy we try to collaborate as much as possible with other projects to | |||
provide this functionality. Examples include: <a href="http://xml.apache.org/cocoon">Cocoon</a> for | |||
which you'll soon find generators and serializers for our projects; | |||
<a href="http://www.openoffice.org">Open Office.org</a> with whom we collaborate in documenting the | |||
XLS format; and <a href="http://jakarta.apache.org/lucene">Lucene</a> for which we'll soon have file | |||
format interpretors. When practical, we donate components directly to those projects for POI-enabling them. | |||
</p> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Why/when would I use POI</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
We'll tackle this on a component level. POI refers to the whole project. | |||
</p> | |||
<p align="justify"> | |||
So why should you use POIFS or HSSF? | |||
</p> | |||
<p align="justify"> | |||
You'd use POIFS if you had a document written in OLE 2 Compound Document Format, probably written using | |||
MFC, that you needed to read in Java. Alternatively, you'd use POI to write OLE 2 Compound Document Format | |||
if you needed to inter-operate with software running on the Windows platform. We are not just bragging when | |||
we say that POIFS is the most complete and correct port of this file format to date! | |||
</p> | |||
<p align="justify"> | |||
You'd use HSSF if you needed to read or write an XLS (Excel) file using Java. You can also read and modify | |||
spreadsheets using this API, although right now writing is more mature. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>What does POI stand for?</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
POI stands for Poor Obfuscation Implementation. Why would we name our project such a derogatory name? Well, | |||
Microsoft's OLE 2 Compound Document Format is a poorly conceived thing. It is essentially an archive structured | |||
much like the old DOS FAT filesystem. Redmond chose, instead of using tar, gzip, zip or arc, to invent their own | |||
archive format that does not provide any standard encryption or compression, is not very appendable and is prone | |||
to fragmentation. | |||
</p> | |||
<p align="justify"> | |||
Poi is also a Hawaiian delicacy that <a href="http://www.m-w.com">Merriam Webster's dictionary</a> defines as: | |||
"A Hawaiian food of taro root cooked, pounded, and kneaded to a paste and often allowed to ferment." This seemed | |||
strangely descriptive of the file format. | |||
</p> | |||
<p align="justify"> | |||
So if you like acronyms, then POI is an acronym. If you hate them, then we just used the name of the food for our | |||
project. If you wish to signify your love or hate for acronyms, use POI or Poi to refer to the project respectively. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Components To Date</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Overview</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
A common misconception is that POI writes Excel files. POI is the name of the project. POI contains several | |||
components, one of which, HSSF, writes Excel files. The following are components of the entire POI project | |||
and a brief summary of their purpose. | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>POIFS</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
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 | |||
definition. Please see <a href="poifs/index.html">the POIFS project page</a> for more information. | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>HSSF</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
HSSF is our port of the Microsoft Excel 97(-2002) file format (BIFF8) to pure Java. It supports read and write | |||
capability. Please see <a href="hssf/index.html">the HSSF project page</a> for more information. | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>HDF</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
HDF is our port of the Microsoft Word 97 file format to pure Java. It supports read and write capability. | |||
Please see <a href="hdf/index.html">the HDF project page for more information</a>. This component is | |||
in the early stages of design. Jump in! | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>What happened to the HSSF Serializer?</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
The HSSF Serializer, which was part of our 1.0 release and last builds on | |||
<a href="http://www.sourceforge.net/projects/poi">Sourceforge</a>, has been donated to the Cocoon project. We're | |||
currently in the process of porting it over. | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Contributing </b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
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 convolution that characterizes Microsoft's file | |||
formats and help us port new ones to a superior Java platform! | |||
</p> | |||
<p align="justify">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! | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,185 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Live Sites using Poi</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Live Sites using Poi</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Live Sites using Poi</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Live Sites using Poi</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">Here is a list of some of the web sites that are proudly using Poi 1.X (in no particular order): | |||
</p> | |||
<!-- | |||
<ul> | |||
<li><link href=""></link></li> | |||
</ul> | |||
</s1> | |||
--> | |||
<p align="justify"> | |||
If you do not find your site here, make sure you tell us | |||
(use the word "Livesites" in the email subject, confirm that | |||
you want to be listed publicly, say which version of Poi, and do not | |||
forget to tell us the URL). | |||
We would like to see this list grow bigger every day :-) | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,198 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Mail Archives</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Mail Archives</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Mail Archives</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Mailing List Archives</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
There are a number of mailing list archives available. | |||
</p> | |||
<table width="100%" cellspacing="2" cellpadding="2" border="0"> | |||
<tr> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>poi-user</em></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>poi-dev</em></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>Regularly updated?</em></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>Searchable?</em></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>Speed</em></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><em>Other features?</em></font></td> | |||
</tr> | |||
<tr> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><a href="http://www.mail-archive.com/poi-user@jakarta.apache.org"> | |||
Apache</a></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><a href="http://www.mail-archive.com/poi-dev@jakarta.apache.org"> | |||
Apache</a></font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Yes</font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">?</font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">?</font></td> | |||
<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">?</font></td> | |||
</tr> | |||
</table> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,318 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Mailing Lists</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Mailing Lists</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Mailing Lists</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Important Notice</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<em>IMPORTANT: Before posting a question or problem to any mailing list, | |||
</em>please first look at the following resources in this order:</p> | |||
<ol> | |||
<li> | |||
<connect href="faq.html" type="simple" show="replace" actuate="user" mode="soft">FAQs</connect> | |||
</li> | |||
<li> | |||
<a href="http://dmoz.org/Computers/Data_Formats/Markup_Languages/XML/">ODP XML links</a> | |||
- a wealth of general XML information.</li> | |||
<li> | |||
<connect href="mail-archives.html" type="simple" show="replace" actuate="user" mode="soft">Mailing list archives</connect> - | |||
a veritable goldmine of Poi-specific information - if you know where to look!</li> | |||
</ol> | |||
<p align="justify"> | |||
<em>IMPORTANT:</em> Careful postings please. | |||
These are high-volume lists, so we all needs ways to help us all | |||
work smarter. | |||
See tips for <a href="contrib.html#tips">Contributing</a> | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Poi Users</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="mailto://poi-user-subscribe@jakarta.apache.org">Subscribe</a> | |||
<a href="mailto://poi-user-unsubscribe@jakarta.apache.org">Unsubscribe</a> | |||
</p> | |||
<p align="justify">The general list, for problems, bug reports, asking for advice on how | |||
best to implement a site, comparisons with other frameworks, etc. | |||
But don't forget to look in the FAQ first, please!</p> | |||
<p align="justify"> | |||
<em>This is also not an appropriate list for general Java questions.</em> | |||
Instead try <a href="news:comp.lang.java.help">news:comp.lang.java.help</a> | |||
or <a href="http://hotdispatch.com/">http://hotdispatch.com/</a>, for | |||
example.</p> | |||
<p align="justify"> | |||
<em>This is not an appropriate list for general XML questions.</em> | |||
Instead | |||
look at the <a href="http://dmoz.org/">ODP</a> for | |||
<a href="http://dmoz.org/Computers/Data_Formats/Markup_Languages/XML/">XML/XSL links</a> | |||
(such as the excellent <a href="http://www.zvon.org/xxl/XSLTutorial/Books/Book1/index.html"> | |||
XSL tutorial at Zvon.org</a>) or try the | |||
<a href="http://www.mulberrytech.com/xsl/">Mulberrytech XSL list</a>.</p> | |||
<p align="justify"> | |||
<em>IMPORTANT:</em> If you are posting about a problem | |||
you are having (as most people do), it will aid in finding a | |||
speedy resolution if you provide full configuration details | |||
(especially the <em>version number</em>, but also your | |||
operating system, JDK version, etc.), and full details of any | |||
errors encountered (including full error messages and stack | |||
traces).</p> | |||
<p align="justify">Please also have some consideration for the other users on the list - this is a | |||
busy list and we do not appreciate getting the exact same message posted impatiently | |||
several times a day/week! Doing so is only likely to make your question answered more | |||
slowly, or not at all, not faster.</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Poi Dev</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="mailto://poi-dev-subscribe@jakarta.apache.org">Subscribe</a> | |||
<a href="mailto://poi-dev-unsubscribe@jakarta.apache.org">Unsubscribe</a> | |||
</p> | |||
<p align="justify">This list is for developers <em>working on</em> or wanting to work on | |||
Poi itself (not developers merely working <em>with</em> Poi), | |||
for code patches to Poi to be posted (please use <code>diff -u</code> format), | |||
and for general Poi questions.</p> | |||
<p align="justify">Note this is <em>NOT</em> for general Poi questions like "Why | |||
isn't Poi working on my machine?" - | |||
please ask those sorts of questions on users list (after reading the | |||
FAQ first, of course).</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Related Mailing Lists</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">(See also <a href="http://dmoz.org/Computers/Data_Formats/Markup_Languages/XML/"> | |||
ODP XML links</a> for related websites.)</p> | |||
<ul> | |||
<li> | |||
<a href="http://xml.apache.org/mail.html">XML Apache Projects</a> - | |||
list of mailing lists for all the projects on xml.apache.org.</li> | |||
<li>Some servlet engines have their own mailing lists for servlet-engine | |||
configuration questions, such as | |||
<a href="mailto:tomcat-user-subscribe@jakarta.apache.org">tomcat-user</a> (note it is "user" | |||
and not "users").</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,283 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Overview</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Overview</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Overview</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>What is it?</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">The 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> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Sub-Projects</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
There following are ports, packages or components contained in the POI project. | |||
</p> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>POIFS</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="poifs/index.html">POIFS</a> is the set of APIs | |||
for reading and writing OLE 2 Compound Document Formats using (only) Java. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>HSSF</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="hssf/index.html">HSSF</a> is the set of APIs | |||
for reading and writing Microsoft Excel 97(-XP) spreadsheet using (only) Java. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>HDF</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="hdf/index.html">HDF</a> is the set of APIs | |||
for reading and writing Microsoft Word 97(-XP) spreadsheet using (only) Java. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>POI-Utils</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
<a href="utils/index.html">POI-Utils</a> are general purpose artifacts | |||
from POI development that have not yet been implemented elsewhere. We're | |||
always looking to donate these and maintain them as part of a general library | |||
used in another project. These are things we need to complete our mission but | |||
are generally outside of it. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,119 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>PoiFS</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Navigation</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="../index.html"><font size="-1">Main</font></a> | |||
</li> | |||
<li> | |||
<a href="how-to.html"><font size="-1">How To</font></a> | |||
</li> | |||
<li> | |||
<a href="usecases.html"><font size="-1">Use Cases</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>PoiFS</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>PoiFS</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Overview</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">POIFS is a pure Java implementation of the OLE 2 Compound | |||
Document format.</p> | |||
<p align="justify">By definition, all APIs developed by the POI project are | |||
based somehow on the POIFS API.</p> | |||
<p align="justify">A common confusion is on just what POIFS buys you or what OLE | |||
2 Compound Document format is exactly. POIFS does not buy you | |||
DOC, or XLS, but is necessary to generate or read DOC or XLS | |||
files. You see, all file formats based on the OLE 2 Compound | |||
Document Format have a common structure. The OLE 2 Compound | |||
Document Format is essentially a convoluted archive | |||
format. Think of POIFS as a "zip" library. Once you can get | |||
the data in a zip file you still need to interpret the | |||
data. As a general rule, while all of our formats <b>use</b> | |||
POIFS, most of them attempt to abstract you from it. There | |||
are some circumstances where this is not possible, but as a | |||
general rule this is true.</p> | |||
<p align="justify">If you're an end user type just looking to generate XLS | |||
files, then you'd be looking for HSSF not POIFS; however, if | |||
you have legacy code that uses MFC property sets, POIFS is | |||
for you! Regardless, you may or may not need to know how to | |||
use POIFS but ultimately if you use technologies that come | |||
from the POI project, you're using POIFS underneith. Perhaps | |||
we should have a branding campaign "POIFS Inside!". ;-)</p> | |||
<p align="justify">TODO: copy POIFS docs and port to XML (in progress). For now | |||
please reference <a href="http://poi.sourceforge.net">old | |||
site</a>.</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,192 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Things To Do for Poi</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Things To Do for Poi</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Things To Do for Poi</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>high</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<sl> | |||
<li> | |||
<em>[code]</em> | |||
do it | |||
</li> | |||
</sl> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>medium</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<sl> | |||
<li> | |||
<em>[code]</em> | |||
do it | |||
</li> | |||
</sl> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,101 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Poi Utils</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Navigation</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="../index.html"><font size="-1">Main</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Poi Utils</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Poi Utils</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Overview</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify">The POI Utils are classes we're looking to donate elsewhere and include. | |||
These are usually classes that while are required for our mission, | |||
are somehow outside of it. General utilities that could be used in | |||
any project are what we would normally put here. If you see one, and you | |||
think "gee that would be great as part of X project" then let us know. | |||
While we wish to put these in their rightful place, we also don't want to | |||
include a 40mb jar file just to process text strings, so that will | |||
be a consideraton. | |||
</p> | |||
<p align="justify"> | |||
Currently, we're looking into which subprojects in the Jakarta Commons project | |||
to donate these too. The "Poi Utils" package won't go away, as there may | |||
be later classes. The idea is that "go ahead and add it, we'll merge it or | |||
find an alternative later, just keep pounding out that poi!" | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -0,0 +1,260 @@ | |||
<html> | |||
<head> | |||
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |||
<title>Who we are</title> | |||
</head> | |||
<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#023264" vlink="#023264" link="#525D76" text="#000000"> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td align="left" valign="top"><a href="http://jakarta.apache.org/index.html"><img src="images/jakarta-logo.gif" border="0" vspace="0" hspace="0"></a></td><td bgcolor="#ffffff" align="left" valign="top" width="100%"><img src="images/header.gif" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
<tr> | |||
<td colspan="2" height="2" width="100%"> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
</table> | |||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> | |||
<tr> | |||
<td valign="top" width="1%"></td><td nowrap="1" valign="top" width="14%"> | |||
<br> | |||
<font face="arial,helvetica,sanserif"> | |||
<br> | |||
<font size="+1" color="#000000">Main</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org"><font size="-1">Jakarta</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">About</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="index.html"><font size="-1">Index</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">History</font></a> | |||
</li> | |||
<li> | |||
<a href="historyandfuture.html"><font size="-1">Future</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sourceforge.net/project/showfiles.php?group_id=32701"><font size="-1">Download</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI10Vision.html"><font size="-1">1.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="plan/POI20Vision.html"><font size="-1">2.0 Vision</font></a> | |||
</li> | |||
<li> | |||
<a href="who.html"><font size="-1">Who we are</font></a> | |||
</li> | |||
<li> | |||
<a href="changes.html"><font size="-1">Changes</font></a> | |||
</li> | |||
<li> | |||
<a href="todo.html"><font size="-1">Todo</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Sub-Projects</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="overview.html"><font size="-1">Overview</font></a> | |||
</li> | |||
<li> | |||
<a href="poifs/index.html"><font size="-1">POIFS</font></a> | |||
</li> | |||
<li> | |||
<a href="hssf/index.html"><font size="-1">HSSF</font></a> | |||
</li> | |||
<li> | |||
<a href="hdf/index.html"><font size="-1">HDF</font></a> | |||
</li> | |||
<li> | |||
<a href="utils/index.html"><font size="-1">POI-Utils</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">References</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="livesites.html"><font size="-1">Live Sites</font></a> | |||
</li> | |||
<li> | |||
<a href="building.xml"><font size="-1">Building</font></a> | |||
</li> | |||
<li> | |||
<a href="http://sc.openoffice.org/excelfileformat.pdf"><font size="-1">XLS spec [PDF]</font></a> | |||
</li> | |||
<li> | |||
<a href="http://xml.apache.org/cocoon/"><font size="-1">Apache Cocoon</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<font size="+1" color="#000000">Get Involved</font><font size="-1"> | |||
<ul> | |||
<li> | |||
<a href="contrib.html"><font size="-1">Contributing</font></a> | |||
</li> | |||
<li> | |||
<a href="https://sourceforge.net/tracker/?atid=406288&group_id=32701&func=browse"><font size="-1">Bug Database</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/cvsindex.html"><font size="-1">CVS</font></a> | |||
</li> | |||
<li> | |||
<a href="http://jakarta.apache.org/site/mail.html"><font size="-1">Mail Lists</font></a> | |||
</li> | |||
</ul> | |||
</font> | |||
<br> | |||
<br> | |||
</font></td><td align="left" valign="top" width="*"> | |||
<title>Who we are</title> | |||
<center> | |||
<table width="80%"> | |||
<tr> | |||
<td bgcolor="#F3DD61"><font face="Arial,sans-serif" size="+1"> | |||
<center> | |||
<b>Who we are</b> | |||
</center> | |||
</font></td> | |||
</tr> | |||
</table> | |||
</center> | |||
<font size="-2" color="#000000"> | |||
<p> | |||
<a href="mailto:"></a> | |||
</p> | |||
</font> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="100%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Who we are</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<p align="justify"> | |||
The Poi Project operates on a meritocracy: the more you do, the more | |||
responsibility you will obtain. This page lists all of the people who have | |||
gone the extra mile and are Committers. If you would like to get involved, | |||
the first step is to join the mailing lists. | |||
</p> | |||
<p align="justify"> | |||
We ask that you please do not send us emails privately asking for support. | |||
We are non-paid volunteers who help out with the project and we do not | |||
necessarily have the time or energy to help people on an individual basis. | |||
Instead, we have set up mailing lists which often contain hundreds of | |||
individuals who will help answer detailed requests for help. The benefit of | |||
using mailing lists over private communication is that it is a shared | |||
resource where others can also learn from common mistakes and as a | |||
community we all grow together. | |||
</p> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Advisors</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<ul> | |||
<li> | |||
<a href="http://jakarta.apache.org/avalon/authors/stefano.html">Stefano Mazzocchi</a> (stefano at apache dot org) | |||
</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Committers</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<ul> | |||
<li> | |||
<a href="http://trilug.org/~acoliver">Andrew C. Oliver</a> (acoliver at apache dot org)</li> | |||
<li> | |||
<a href="http://www.marcj.com">Marc Johnson</a> (mjohnson at apache dot org)</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
<div align="right"> | |||
<table cellspacing="0" cellpadding="2" border="0" width="99%"> | |||
<tr> | |||
<td bgcolor="#525D76"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Developers</b></font></font></td> | |||
</tr> | |||
<tr> | |||
<td> | |||
<br> | |||
<ul> | |||
<li>Glen Stampoultzis (glens at apache.org)</li> | |||
<li>Nicola Ken Barozzi (barozzi at nicolaken dot com)</li> | |||
</ul> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<br> | |||
</td> | |||
</tr> | |||
</table> | |||
<br> | |||
<table cellpadding="0" cellspacing="0" border="0" width="100%"> | |||
<tr> | |||
<td> | |||
<hr size="1" noshade=""> | |||
</td> | |||
</tr> | |||
<tr> | |||
<td align="center"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i> | |||
Copyright ©2002 Apache Software Foundation | |||
</i></font></td><td width="5%" align="right"><img src="images/cocoon2-small.jpg" align="right" border="0" vspace="0" hspace="0"></td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |