diff options
| author | Nicola Ken Barozzi <nicolaken@apache.org> | 2002-04-15 08:06:44 +0000 |
|---|---|---|
| committer | Nicola Ken Barozzi <nicolaken@apache.org> | 2002-04-15 08:06:44 +0000 |
| commit | a9973d075640901a71f2cbc7946cf89370efeba0 (patch) | |
| tree | 17ed681482c20477095528379a5722c6527fb7e6 | |
| parent | 5d6947fab87c93f53bf62a5a2d8dc43ac77dea06 (diff) | |
| download | poi-a9973d075640901a71f2cbc7946cf89370efeba0.tar.gz poi-a9973d075640901a71f2cbc7946cf89370efeba0.zip | |
Removing generated docs since Andy does it automatically from
build every 2 hours with a script. :-)
git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@352419 13f79535-47bb-0310-9956-ffa450edef68
88 files changed, 0 insertions, 17127 deletions
diff --git a/build/jakarta-poi/docs/changes.html b/build/jakarta-poi/docs/changes.html deleted file mode 100644 index 2f3a0c53dd..0000000000 --- a/build/jakarta-poi/docs/changes.html +++ /dev/null @@ -1,431 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>History of Changes</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>History of Changes</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">History of Changes</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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.5-dev (03-April-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> - -<li> -<icon alt="update" src="images/update.jpg"></icon>Package rename(POI-DEVELOPERS)</li> - -<li> -<icon alt="fix" src="images/fix.jpg"></icon>Various bug fixes(POI-DEVELOPERS)</li> - -<li> -<icon alt="add" src="images/add.jpg"></icon>Early stages of HSF development (not ready for development)(POI-DEVELOPERS)</li> - -<li> -<icon alt="add" src="images/add.jpg"></icon>Initial low level record support for charting (not complete)(POI-DEVELOPERS)</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> 1.1.0 ()</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Created new event model(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Optimizations made to HSSF including aggregate records for - values, rows, etc.(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>predictive sizing, offset based writing (instead of lots of - array copies)(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>minor re-factoring and bug fixes.(POI-DEVELOPERS)</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> 1.0.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Minor documentation updates.(POI-DEVELOPERS)</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> 0.14.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Added DataFormat helper class and exposed set and get format - on HSSFCellStyle(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Fixed column width apis (unit wise) and various javadoc on - the subject(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Fix for Dimensions record (again)... (one of these days I'll - write a unit test for this ;-p).(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Some optimization on sheet creation.(POI-DEVELOPERS)</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> 0.13.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - - -</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> 0.12.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Added MulBlank, Blank, ColInfo(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Added log4j facility and removed all sys.out type logging(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Added support for adding font's, styles and corresponding - high level api for styling cells(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>added support for changing row height, cell width and default - row height/cell width.(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Added fixes for internationalization (UTF-16 should work now - from HSSFCell.setStringValue, etc when the encoding is set)(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>added support for adding/removing and naming sheets.(POI-DEVELOPERS)</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> 0.11.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Bugfix release. We were throwing an exception when reading - RKRecord objects.(POI-DEVELOPERS)</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> 0.10.0 (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Got continuation records to work (read/write)(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Added various pre-support for formulas(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Massive API reorganization, repackaging.(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>BiffViewer class added for validating HSSF & POI and/or - HSSF Output.(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Better API support for modification.(POI-DEVELOPERS)</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> 0.7 (and interim releases) (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Added encoding flag to high and low level api to use utf-16 - when needed (HSSFCell.setEncoding())(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>added read only support for Label records (which are - reinterpreted as LabelSST when written)(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Broken continuation record implementation (oops)(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>BiffViewer class added for validating HSSF & POI and/or - HSSF Output.(POI-DEVELOPERS)</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> 0.6 (release) (???)</b></font></font></td> -</tr> -<tr> -<td> -<br> -<sl> - -<li> -<icon alt="" src="images/.jpg"></icon>Support for read/write and modify.(POI-DEVELOPERS)</li> - -<li> -<icon alt="" src="images/.jpg"></icon>Read only support for MulRK records (converted to Number when - writing) - (POI-DEVELOPERS)</li> - -</sl> -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/contrib.html b/build/jakarta-poi/docs/contrib.html deleted file mode 100644 index a71f5ddc75..0000000000 --- a/build/jakarta-poi/docs/contrib.html +++ /dev/null @@ -1,532 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Contribution to POI</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Contribution to POI</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Contribution to POI</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/faq.html b/build/jakarta-poi/docs/faq.html deleted file mode 100644 index 5a45e2d2a0..0000000000 --- a/build/jakarta-poi/docs/faq.html +++ /dev/null @@ -1,248 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Frequently Asked Questions</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Frequently Asked Questions</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Frequently Asked Questions</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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> -<li> -<jump anchor="faq-2"> - Why can't read the document I created using Star Office 5.1? - </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> - - - -</td> -</tr> -</table> -</div> -<br> -<anchor id="faq-2"></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> - Why can't read the document I created using Star Office 5.1? - </b></font></font></td> -</tr> -<tr> -<td> -<br> - - - -<p align="justify"> - Star Office 5.1 writes some records using the older BIFF standard. This causes some problems - with POI which supports only BIFF8. - </p> - - - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hdf/images/built-with-cocoon.gif b/build/jakarta-poi/docs/hdf/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/hdf/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hdf/images/cocoon2-small.jpg b/build/jakarta-poi/docs/hdf/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/hdf/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/hdf/images/header.gif b/build/jakarta-poi/docs/hdf/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/hdf/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hdf/images/jakarta-logo.gif b/build/jakarta-poi/docs/hdf/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/hdf/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hdf/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/hdf/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/hdf/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/hdf/index.html b/build/jakarta-poi/docs/hdf/index.html deleted file mode 100644 index 296b279a0b..0000000000 --- a/build/jakarta-poi/docs/hdf/index.html +++ /dev/null @@ -1,124 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HDF</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HDF</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HDF</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/historyandfuture.html b/build/jakarta-poi/docs/historyandfuture.html deleted file mode 100644 index fca0fe3d27..0000000000 --- a/build/jakarta-poi/docs/historyandfuture.html +++ /dev/null @@ -1,274 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hpsf/how-to.html b/build/jakarta-poi/docs/hpsf/how-to.html deleted file mode 100644 index 12655dd39a..0000000000 --- a/build/jakarta-poi/docs/hpsf/how-to.html +++ /dev/null @@ -1,622 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HPSF HOW-TO</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HPSF</span> -<br> -<a class="s1" href="index.html">Overview</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="internals.html">Internals</a> -<br> -<a class="s1" href="todo.html">To Do</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HPSF HOW-TO</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HPSF HOW-TO</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>How To Use the HPSF APIs</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">This HOW-TO is organized in three section. You should read them - sequentially because the later sections build upon the earlier ones.</p> - - -<ol> - -<li> - -<p align="justify">The <a href="#sec1">first section</a> explains how to read - the most important standard properties of a Microsoft Office - document. Standard properties are things like title, author, creation - date etc. It is quite likely that you will find here what you need and - don't have to read the other sections.</p> - -</li> - - -<li> - -<p align="justify">The <a href="#sec2">second section</a> goes a small step - further and focusses on reading additional standard properties. It also - talks about exceptions that may be thrown when dealing with HPSF and - shows how you can read properties of embedded objects.</p> - -</li> - - -<li> - -<p align="justify">The <a href="#sec3">third section</a> tells how to read - non-standard properties. Non-standard properties are application-specific - name/value/type triples.</p> - -</li> - -</ol> - - -<anchor id="sec1"></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>Reading Standard Properties</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<note>This section explains how to read - the most important standard properties of a Microsoft Office - document. Standard properties are things like title, author, creation - date etc. Chances are that you will find here what you need and - don't have to read the other sections.</note> - - -<p align="justify">The first thing you should understand is that properties are stored in - separate documents inside the POI filesystem. (If you don't know what a - POI filesystem is, read its <a href="../poifs/index.html">documentation</a>.) A document in a POI - filesystem is also called a <em>stream</em>.</p> - - -<p align="justify">The following example shows how to read a POI filesystem's - "title" property. Reading other properties is similar. Consider the API - documentation of <code>org.apache.poi.hpsf.SummaryInformation</code>.</p> - - -<p align="justify">The standard properties this section focusses on can be - found in a document called <em>\005SummaryInformation</em> in the root of - the POI filesystem. The notation <em>\005</em> in the document's name - means the character with the decimal value of 5. In order to read the - title, an application has to perform the following steps:</p> - - -<ol> - -<li> - -<p align="justify">Open the document <em>\005SummaryInformation</em> located in the root - of the POI filesystem.</p> - -</li> - -<li> - -<p align="justify">Create an instance of the class - <code>SummaryInformation</code> from that - document.</p> - -</li> - -<li> - -<p align="justify">Call the <code>SummaryInformation</code> instance's - <code>getTitle()</code> method.</p> - -</li> - -</ol> - - -<p align="justify">Sounds easy, doesn't it? Here are the steps in detail.</p> - - - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Open the document \005SummaryInformation in the root of the POI filesystem</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">An application that wants to open a document in a POI filesystem - (POIFS) proceeds as shown by the following code fragment. (The full - source code of the sample application is available in the - <em>examples</em> section of the POI source tree as - <em>ReadTitle.java</em>.)</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -import java.io.*; -import org.apache.poi.hpsf.*; -import org.apache.poi.poifs.eventfilesystem.*; - -// ... - -public static void main(String[] args) - throws IOException -{ - final String filename = args[0]; - POIFSReader r = new POIFSReader(); - r.registerListener(new MyPOIFSReaderListener(), - "\005SummaryInformation"); - r.read(new FileInputStream(filename)); -}</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">The first interesting statement is</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre>POIFSReader r = new POIFSReader();</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">It creates a - <code>org.apache.poi.poifs.eventfilesystem.POIFSReader</code> instance - which we shall need to read the POI filesystem. Before the application - actually opens the POI filesystem we have to tell the - <code>POIFSReader</code> which documents we are interested in. In this - case the application should do something with the document - <em>\005SummaryInformation</em>.</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -r.registerListener(new MyPOIFSReaderListener(), - "\005SummaryInformation");</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">This method call registers a - <code>org.apache.poi.poifs.eventfilesystem.POIFSReaderListener</code> - with the <code>POIFSReader</code>. The <code>POIFSReaderListener</code> - interface specifies the method <code>processPOIFSReaderEvent</code> - which processes a document. The class - <code>MyPOIFSReaderListener</code> implements the - <code>POIFSReaderListener</code> and thus the - <code>processPOIFSReaderEvent</code> method. The eventing POI filesystem - calls this method when it finds the <em>\005SummaryInformation</em> - document. In the sample application <code>MyPOIFSReaderListener</code> is - a static class in the <em>ReadTitle.java</em> source file.)</p> - - -<p align="justify">Now everything is prepared and reading the POI filesystem can - start:</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre>r.read(new FileInputStream(filename));</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">The following source code fragment shows the - <code>MyPOIFSReaderListener</code> class and how it retrieves the - title.</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -static class MyPOIFSReaderListener implements POIFSReaderListener -{ - public void processPOIFSReaderEvent(POIFSReaderEvent e) - { - SummaryInformation si = null; - try - { - si = (SummaryInformation) - PropertySetFactory.create(e.getStream()); - } - catch (Exception ex) - { - throw new RuntimeException - ("Property set stream \"" + - event.getPath() + event.getName() + "\": " + ex); - } - final String title = si.getTitle(); - if (title != null) - System.out.println("Title: \"" + title + "\""); - else - System.out.println("Document has no title."); - } -} -</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">The line</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre>SummaryInformation si = null;</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">declares a <code>SummaryInformation</code> variable and initializes it - with <code>null</code>. We need an instance of this class to access the - title. The instance is created in a <code>try</code> block:</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre>si = (SummaryInformation) - PropertySetFactory.create(e.getStream());</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">The expression <code>e.getStream()</code> returns the input stream - containing the bytes of the property set stream named - <em>\005SummaryInformation</em>. This stream is passed into the - <code>create</code> method of the factory class - <code>org.apache.poi.hpsf.PropertySetFactory</code> which returns - a <code>org.apache.poi.hpsf.PropertySet</code> instance. It is more or - less safe to cast this result to <code>SummaryInformation</code>, a - convenience class with methods like <code>getTitle()</code>, - <code>getAuthor()</code> etc.</p> - - -<p align="justify">The <code>PropertySetFactory.create</code> method may throw all sorts - of exceptions. We'll deal with them in the next sections. For now we just - catch all exceptions and throw a <code>RuntimeException</code> - containing the message text of the origin exception.</p> - - -<p align="justify">If all goes well, the sample application retrieves the title and prints - it to the standard output. As you can see you must be prepared for the - case that the POI filesystem does not have a title.</p> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre>final String title = si.getTitle(); - if (title != null) - System.out.println("Title: \"" + title + "\""); - else - System.out.println("Document has no title.");</pre> -</td> -</tr> -</table> -</div> - - -<p align="justify">Please note that a Microsoft Office document does not necessarily - contain the <em>\005SummaryInformation</em> stream. The documents created - by the Microsoft Office suite have one, as far as I know. However, an - Excel spreadsheet exported from StarOffice 5.2 won't have a - <em>\005SummaryInformation</em> stream. In this case the applications - won't throw an exception but simply does not call the - <code>processPOIFSReaderEvent</code> method. You have been warned!</p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> - - -<anchor id="sec2"></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>Additional Standard Properties, Exceptions And Embedded Objects</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<note>This section focusses on reading additional standard properties. It - also talks about exceptions that may be thrown when dealing with HPSF and - shows how you can read properties of embedded objects.</note> - - -<p align="justify">A couple of <em>additional standard properties</em> are not - contained in the <em>\005SummaryInformation</em> stream explained above, - for example a document's category or the number of multimedia clips in a - PowerPoint presentation. Microsoft has invented an additional stream named - <em>\005DocumentSummaryInformation</em> to hold these properties. With two - minor exceptions you can proceed exactly as described above to read the - properties stored in <em>\005DocumentSummaryInformation</em>:</p> - - -<ul> - -<li> -<p align="justify">Instead of <em>\005SummaryInformation</em> use - <em>\005DocumentSummaryInformation</em> as the stream's name.</p> -</li> - -<li> -<p align="justify">Replace all occurrences of the class - <code>SummaryInformation</code> by - <code>DocumentSummaryInformation</code>.</p> -</li> - -</ul> - - -<p align="justify">And of course you cannot call <code>getTitle()</code> because - <code>DocumentSummaryInformation</code> has different query methods. See - the API documentation for the details!</p> - - -<p align="justify">In the previous section the application simply caught all - <em>exceptions</em> and was in no way interested in any - details. However, a real application will likely want to know what went - wrong and act appropriately. Besides any IO exceptions there are three - HPSF resp. POI specific exceptions you should know about:</p> - - -<dl> - -<dt> -<code>NoPropertySetStreamException</code>:</dt> - -<dd> -<p align="justify">This exception is thrown if the application tries to create a - <code>PropertySet</code> or one of its subclasses - <code>SummaryInformation</code> and - <code>DocumentSummaryInformation</code> from a stream that is not a - property set stream. A faulty property set stream counts as not being a - property set stream at all. An application should be prepared to deal - with this case even if opens streams named - <em>\005SummaryInformation</em> or - <em>\005DocumentSummaryInformation</em> only. These are just names. A - stream's name by itself does not ensure that the stream contains the - expected contents and that this contents is correct.</p> -</dd> - - -<dt> -<code>UnexpectedPropertySetTypeException</code> -</dt> - -<dd> -<p align="justify">This exception is thrown if a certain type of property set is - expected somewhere (e.g. a <code>SummaryInformation</code> or - <code>DocumentSummaryInformation</code>) but the provided property - set is not of that type.</p> -</dd> - - -<dt> -<code>MarkUnsupportedException</code> -</dt> - -<dd> -<p align="justify">This exception is thrown if an input stream that is to be parsed - into a property set does not support the - <code>InputStream.mark(int)</code> operation. The POI filesystem uses - the <code>DocumentInputStream</code> class which does support this - operation, so you are safe here. However, if you read a property set - stream from another kind of input stream things may be - different.</p> -</dd> - -</dl> - - -<p align="justify">Many Microsoft Office documents contain <em>embedded - objects</em>, for example an Excel sheet on a page in a Word - document. Embedded objects may have property sets of their own. An - application can open these property set streams as described above. The - only difference is that they are not located in the POI filesystem's root - but in a nested directory instead. Just register a - <code>POIFSReaderListener</code> for the property set streams you are - interested in. For example, the <em>POIBrowser</em> application in the - contrib section tries to open each and every document in a POI filesystem - as a property set stream. If this operation was successful it displays the - properties.</p> - -</td> -</tr> -</table> -</div> -<br> - - -<anchor id="sec3"></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>Reading Non-Standard Properties</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<note>This section tells how to read - non-standard properties. Non-standard properties are application-specific - name/value/type triples.</note> - - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td bgcolor="#c0c0c0"><font size="-1" color="#023264">Write this section!</font></td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hpsf/images/built-with-cocoon.gif b/build/jakarta-poi/docs/hpsf/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/hpsf/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hpsf/images/cocoon2-small.jpg b/build/jakarta-poi/docs/hpsf/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/hpsf/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/hpsf/images/header.gif b/build/jakarta-poi/docs/hpsf/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/hpsf/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hpsf/images/jakarta-logo.gif b/build/jakarta-poi/docs/hpsf/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/hpsf/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hpsf/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/hpsf/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/hpsf/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/hpsf/index.html b/build/jakarta-poi/docs/hpsf/index.html deleted file mode 100644 index 4360f8f3b2..0000000000 --- a/build/jakarta-poi/docs/hpsf/index.html +++ /dev/null @@ -1,143 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HPSF (Horrible Property Set Format)</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HPSF</span> -<br> -<a class="s1" href="index.html">Overview</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="internals.html">Internals</a> -<br> -<a class="s1" href="todo.html">To Do</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HPSF (Horrible Property Set Format)</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HPSF (Horrible Property Set Format)</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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">Microsoft applications like "Word" or "Excel" let the user describe his - document by properties like "title", "category" and so on. The application - itself adds further information: last author, creation date etc. These - properties are stored in so-called <em>property set streams</em>. A - property set stream is a separate document within a <a href="../poifs/index.html">POI filesystem</a>. HPSF is POI's pure-Java - implementation to read (and in future to write) property set streams.</p> - - -<p align="justify">The <a href="how-to.html">HPSF HOWTO</a> describes what a Java - application should do to read a property set using HPSF and to retrieve the - information it needs.</p> - - -<p align="justify">HPSF supports OLE2 property set streams in general, not only the special - case of document properties mentioned above. The <a href="internals.html">HPSF description</a> describes the internal - structure of property set streams.</p> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hpsf/internals.html b/build/jakarta-poi/docs/hpsf/internals.html deleted file mode 100644 index d30d9e3177..0000000000 --- a/build/jakarta-poi/docs/hpsf/internals.html +++ /dev/null @@ -1,2578 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HPSF Internals: The Horrible Property Set Format</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HPSF</span> -<br> -<a class="s1" href="index.html">Overview</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="internals.html">Internals</a> -<br> -<a class="s1" href="todo.html">To Do</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HPSF Internals: The Horrible Property Set Format</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HPSF Internals: The Horrible Property Set Format</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>HPSF Internals</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>Introduction</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">A Microsoft Office document is internally organized like a filesystem - with directory and files. Microsoft calls these files - <em>streams</em>. A document can have properties attached to it, - like author, title, number of words etc. These metadata are not stored in - the main stream of, say, a Word document, but instead in a dedicated - stream with a special format. Usually this stream's name is - <code>\005SummaryInformation</code>, where <code>\005</code> represents - the character with a decimal value of 5.</p> - - -<p align="justify">A single piece of information in the stream is called a - <em>property</em>, for example the document title. Each property - has an integral <em>ID</em> (e.g. 2 for title), a - <em>type</em> (telling that the title is a string of bytes) and a - <em>value</em> (what this is should be obvious). A stream - containing properties is called a - <em>property set stream</em>.</p> - - -<p align="justify">This document describes the internal structure of a property set stream, - i.e. the <em>Horrible Property Set Format (HDF)</em>. It does not - describe how a Microsoft Office document is organized internally and how - to retrieve a stream from it. See the <a href="../poifs/index.html">POIFS documentation</a> for that kind of - stuff.</p> - - -<p align="justify">The Horrible Property Set Format is not only used in the Summary - Information stream in the top-level document of a Microsoft Office - document. Often there is also a property set stream named - <code>\005DocumentSummaryInformation</code> with additional properties. - Embedded documents may have their own property set streams. You cannot - tell by a stream's name whether it is a property set stream or not. - Instead you have to open the stream and look at its bytes.</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>Data Types</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">Before delving into the details of the property set stream format we - have to have a short look at data types. Integral values are stored in the - so-called <em>little endian</em> format. In this format the bytes - that make out an integral value are stored in the "wrong" order. For - example, the decimal value 4660 is 0x1234 in the hexadecimal notation. If - you think this should be represented by a byte 0x12 followed by another - byte 0x34, you are right. This is called the <em>big endian</em> - format. In the little endian format, however, this order is reversed and - the low-value byte comes first: 0x3412. - </p> - - -<p align="justify">The following table gives an overview about some important data - types:</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> - -<p align="justify">Name</p> - -</tr> - -<tr> - -<p align="justify">Length</p> - -</tr> - -<tr> - -<p align="justify">Example (Little Endian)</p> - -</tr> - -<tr> - -<p align="justify">Example (Big Endian)</p> - -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<em>Bytes</em> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">1 byte</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x12</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x12</code> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<em>Word</em> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">2 bytes</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x1234</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x3412</code> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<em>DWord</em> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">4 bytes</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x12345678</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x78563412</code> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<em>ClassID</em> -</p> - -<p align="justify">A sequence of one DWord, two Words and eight Bytes</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">16 bytes</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<code>0xE0859FF2F94F6810AB9108002B27B3D9</code> resp. - <code>E0859FF2-F94F-6810-AB-91-08-00-2B-27-B3-D9</code> -</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<code>0xF29F85E04FF91068AB9108002B27B3D9</code> resp. - <code>F29F85E0-4FF9-1068-AB-91-08-00-2B-27-B3-D9</code> -</p> - -</font></td> - -</tr> -<tr> - -<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"> - -<p align="justify">The ClassID examples are given here in two different notations. The - second notation without the "0x" at the beginning and with dashes - inside shows the internal grouping into one DWord, two Words and eight - Bytes.</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<em>Watch out:</em> Microsoft documentation and tools show class IDs - a little bit differently like - <code>F29F85E0-4FF9-1068-AB91-08002B27B3D9</code>. - However, that representation is (intentionally?) misleading with - respect to endianess.</p> - -</font></td> - -</tr> -</table> - -</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>HPSF Overview</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">A property set stream consists of three main parts:</p> - - -<ol> - -<li> - -<p align="justify">The <em>header</em> and</p> - -</li> - -<li> - -<p align="justify">the <em>section(s)</em> containing the properties.</p> - -</li> - -</ol> - -</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>The Header</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The first bytes in a property set stream is the <em>header</em>. - It has a fixed length and looks like this:</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> - -<p align="justify">Offset</p> - -</tr> - -<tr> - -<p align="justify">Type</p> - -</tr> - -<tr> - -<p align="justify">Contents</p> - -</tr> - -<tr> - -<p align="justify">Remarks</p> - -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">0</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Word</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0xFFFE</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">If the first four bytes of a stream do not contain these values, the - stream is not a property set stream.</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">2</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Word</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x0000</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">4</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Denotes the operating system and the OS version under which this - stream was created. The operating system ID is in the DWord's higher - word (after little endian decoding): <code>0x0000</code> for Win16, - <code>0x0001</code> for Macintosh and <code>0x0002</code> for Win32 - that's - all. The reader is most likely aware of the fact that there are some - more operating systems. However, Microsoft does not seem to know.</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">8</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">ClassID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<code>0x00000000000000000000000000000000</code> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Most property set streams have this value but this is not - required.</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">24</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<code>0x01000000</code> or greater</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Section count. This field's value should be equal to 1 or greater. - Microsoft claims that this is a "reserved" field, but it seems to tell - how many sections (see below) are following in the stream. This would - really make sense because otherwise you could not know where and how - far you should read section data.</p> - -</font></td> - -</tr> -</table> - -</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>Section List</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">Following the header is the section list. This is an array of pairs each - consisting of a section format ID and an offset. This array has as many - pairs of ClassID and and DWord fields as the section count field in the - header says. The Summary Information stream contains a single section, the - Document Summary Information stream contains two.</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> - -<p align="justify">Type</p> - -</tr> - -<tr> - -<p align="justify">Contents</p> - -</tr> - -<tr> - -<p align="justify">Remarks</p> - -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">ClassID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Section format ID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify"> -<code>0xF29F85E04FF91068AB9108002B27B3D9</code> for the single section - in the Summary Information stream.</p> - - -<p align="justify"> -<code>0xD5CDD5022E9C101B939708002B2CF9AE</code> for the first - section in the Document Summary Information stream.</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Offset</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">The number of bytes between the beginning of the stream and the - beginning of the section within the stream.</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">ClassID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Section format ID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Offset</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - -</tr> -</table> - -</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>Section</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">A section is divided into three parts: the section header (with the - section length and the number of properties in the section), the - properties list (with type and offset of each property), and the - properties themselves. Here are the details:</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> - -<p align="justify"> </p> - -</tr> - -<tr> - -<p align="justify">Type</p> - -</tr> - -<tr> - -<p align="justify">Contents</p> - -</tr> - -<tr> - -<p align="justify">Remarks</p> - -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Section header</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Length</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">The length of the section in bytes.</p> - -</font></td> - -</tr> -<tr> - -<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"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Property count</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">The number of properties in the section.</p> - -</font></td> - -</tr> -<tr> - - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Properties list</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Property ID</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">The property ID tells what the property means. For example, an ID of - <code>0x0002</code> in the Summary Information stands for the document's - title. See the <a href="#property_ids">Property IDs</a> - chapter below for more details.</p> - -</font></td> - -</tr> -<tr> - -<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"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Offset</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">The number of bytes between the beginning of the section and the - property.</p> - -</font></td> - -</tr> -<tr> - -<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"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Properties</p> - -</font></td> - - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">DWord</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Property type ("variant")</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">This is the property's data type, e.g. an integer value, a byte - string or a Unicode string. See the - <a href="#property_types"><em>Property Types</em></a> chapter for - details!</p> - -</font></td> - -</tr> -<tr> - -<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"> -<p align="justify"> -<em>Field length depends on the property type - ("variant")</em> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Property value</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">This field's length depends on the property's type. These are the - bytes that make out the DWord, the byte string or some other data of - fixed or variable length.</p> - - -<p align="justify">The property value's length is always stored in an area which is a - multiple of 4 in length. If the property is shorter, e.g. a byte - string of 13 bytes, the remaining bytes are padded with <code>0x00</code> - bytes.</p> - -</font></td> - -</tr> -<tr> - -<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"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">...</p> - -</font></td> - -</tr> -</table> - -</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>Property IDs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<anchor id="property_ids"></anchor> - - -<p align="justify">As seen above, a section holds a property list: an array with property - IDs and offsets. The property ID gives each property a meaning. For - example, in the Summary Information stream the property ID 2 says that - this property is the document's title.</p> - - -<p align="justify">If you want to know a property ID's meaning, it is not sufficient to - know the ID itself. You must also know the - <em>section format ID</em>. For example, in the Document Summary - Information stream the property ID 2 means not the document's title but - its category. Due to Microsoft's infinite wisdom the section format ID is - not part of the section. Thus if you have only a section without the - stream it is in, you cannot make any sense of the properties because you - do not know what they mean.</p> - - -<p align="justify">So each section format ID has its own name space of property IDs. - Microsoft defined some "well-known" property IDs for the Summary - Information and the Document Summary Information streams. You can extend - them by your own additional IDs. This will be described below.</p> - - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Property IDs in The Summary Information Stream</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The Summary Information stream has a single section with a section - format ID of <code>0xF29F85E04FF91068AB9108002B27B3D9</code>. The following - table defines the meaning of its property IDs. Each row associates a - property ID with a <em>name</em> and an <em>ID string</em>. (The property - <em>type</em> is just for informational purposes given here. As we have - seen above, the type is always given along with the value.)</p> - - -<p align="justify">The property <em>name</em> is a readable string which could be - displayed to the user. However, this string is useful only for users who - understand English. The property name does not help with other - languages.</p> - - -<p align="justify">The property <em>ID string</em> is about the same but looks more - technically and is nothing a user should bother with. You could the ID - string and map it to an appropriate display string in a particular - language. Of course you could do that with the property ID as well and - with less overhead, but people (including software developers) tend to be - better in remembering symbolic constants than remembering numbers.</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> -<p align="justify">Property ID</p> -</tr> - -<tr> -<p align="justify">Property Name</p> -</tr> - -<tr> -<p align="justify">Property ID String</p> -</tr> - -<tr> -<p align="justify">Property Type</p> -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">2</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Title</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_TITLE</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">3</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Subject</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_SUBJECT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Author</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_AUTHOR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">5</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Keywords</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_KEYWORDS</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">6</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Comments</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_COMMENTS</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">7</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Template</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_TEMPLATE</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Last Saved By</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_LASTAUTHOR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">9</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Revision Number</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_REVNUMBER</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">10</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Total Editing Time</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_EDITTIME</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_FILETIME</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">11</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Last Printed</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_LASTPRINTED</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_FILETIME</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">12</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Create Time/Date</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_CREATE_DTM</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_FILETIME</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">13</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Last Saved Time/Date</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_LASTSAVE_DTM</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_FILETIME</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">14</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Number of Pages</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_PAGECOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">15</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Number of Words</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_WORDCOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">16</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Number of Characters</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_CHARCOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">17</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Thumbnail</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_THUMBNAIL</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_CF</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">18</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Name of Creating Application</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_APPNAME</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">19</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Security</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_SECURITY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - - - - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Property IDs in The Document Summary Information Stream</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The Document Summary Information stream has two sections with a section - format ID of <code>0xD5CDD5022E9C101B939708002B2CF9AE</code> for the first - one. The following table defines the meaning of the property IDs in the - first section. See the preceeding section for interpreting the table.</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> -<p align="justify">Property ID</p> -</tr> - -<tr> -<p align="justify">Property name</p> -</tr> - -<tr> -<p align="justify">Property ID string</p> -</tr> - -<tr> -<p align="justify">VT type</p> -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">2</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Category</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_CATEGORY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">3</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PresentationTarget</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_PRESFORMAT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Bytes</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_BYTECOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">5</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Lines</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_LINECOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">6</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Paragraphs</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_PARCOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">7</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Slides</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_SLIDECOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Notes</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_NOTECOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">9</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">HiddenSlides</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_HIDDENCOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">10</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">MMClips</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_MMCLIPCOUNT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">11</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">ScaleCrop</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_SCALE</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BOOL</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">12</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">HeadingPairs</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_HEADINGPAIR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_VARIANT | VT_VECTOR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">13</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">TitlesofParts</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_DOCPARTS</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR | VT_VECTOR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">14</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Manager</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_MANAGER</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">15</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Company</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_COMPANY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">16</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">LinksUpTo Date</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">PID_LINKSDIRTY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BOOL</p> -</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -</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>Property Types</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<anchor id="property_types"></anchor> - - -<p align="justify">A property consists of a DWord <em>type field</em> followed by the - property value. The property type is an integer value and tells how the - data byte following it are to be interpreted. In the Microsoft world it is - also known as the <em>variant</em>.</p> - - -<p align="justify">The <em>Usage</em> column says where a variant type may occur. Not all - of them are allowed in a property set but just those marked with a [P]. - <em>[V]</em> - may appear in a VARIANT, <em>[T]</em> - may - appear in a TYPEDESC, <em>[P]</em> - may appear in an OLE property - set, <em>[S]</em> - may appear in a Safe Array.</p> - - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<tr> -<p align="justify">Variant ID</p> -</tr> - -<tr> -<p align="justify">Variant Type</p> -</tr> - -<tr> -<p align="justify">Usage</p> -</tr> - -<tr> -<p align="justify">Description</p> -</tr> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_EMPTY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">nothing</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">1</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_NULL</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">SQL style Null</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">2</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I2</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">2 byte signed int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">3</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">4 byte signed int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_R4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">4 byte real</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">5</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_R8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">8 byte real</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">6</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_CY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">currency</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">7</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_DATE</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">date</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BSTR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">OLE Automation string</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">9</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_DISPATCH</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">IDispatch *</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">10</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_ERROR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">SCODE</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">11</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BOOL</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">True=-1, False=0</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">12</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_VARIANT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VARIANT *</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">13</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UNKNOWN</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">IUnknown *</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">14</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_DECIMAL</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">16 byte fixed point</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">16</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I1</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">signed char</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">17</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UI1</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V] [T] [P] [S]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">unsigned char</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">18</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UI2</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">unsigned short</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">19</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UI4</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">unsigned short</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">20</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_I8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">signed 64-bit int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">21</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UI8</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">unsigned 64-bit int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">22</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_INT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">signed machine int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">23</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_UINT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">unsigned machine int</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">24</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_VOID</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">C style void</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">25</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_HRESULT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Standard return type</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">26</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_PTR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">pointer type</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">27</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_SAFEARRAY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">(use VT_ARRAY in VARIANT)</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">28</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_CARRAY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">C style array</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">29</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_USERDEFINED</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">user defined type</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">30</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPSTR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">null terminated string</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">31</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_LPWSTR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[T] [P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">wide null terminated string</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">64</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_FILETIME</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">FILETIME</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">65</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BLOB</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Length prefixed bytes</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">66</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_STREAM</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Name of the stream follows</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">67</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_STORAGE</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Name of the storage follows</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">68</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_STREAMED_OBJECT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Stream contains an object</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">69</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_STORED_OBJECT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Storage contains an object</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">70</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BLOB_OBJECT</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Blob contains an object</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">71</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_CF</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">Clipboard format</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">72</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_CLSID</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">A Class ID</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0x1000</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_VECTOR</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[P]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">simple counted array</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0x2000</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_ARRAY</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">SAFEARRAY*</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0x4000</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_BYREF</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">[V]</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">void* for local use</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0x8000</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_RESERVED</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0xFFFF</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_ILLEGAL</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0xFFF</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_ILLEGALMASKED</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">0xFFF</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify">VT_TYPEMASK</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> -<p align="justify"> -<p align="justify"></p> -</p> -</font></td> - -</tr> -</table> - -</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>References</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">In order to assemble the HPSF description I used information publically - available on the Internet only. The references given below have been very - helpful. If you have any amendments or corrections, please let us know! - Thank you!</p> - - -<ol> - - -<li> - -<p align="justify">In - <a href="http://www.kyler.com/pubs/ddj9894.html"><em>Understanding OLE - documents</em></a>, Ken Kyler gives an introduction to OLE2 - documents - and especially to property sets. He names the property names, types, and - IDs of the Summary Information and Document Summary Information - stream.</p> - -</li> - - -<li> - -<p align="justify">The - <a href="http://www.dwam.net/docs/oleref/"><em>ActiveX Programmer's - Reference</em></a> at - <a href="http://www.dwam.net/docs/oleref/">http://www.dwam.net/docs/oleref/</a> - seems a little outdated, but that's what I have found.</p> - -</li> - - -<li> - -<p align="justify">An overview of the <code>VT_</code> types is in - <a href="http://www.marin.clara.net/COM/variant_type_definitions.htm"><em>Variant - Type Definitions</em></a>.</p> - -</li> - - -<li> - -<p align="justify">What is a <code>FILETIME</code>? The answer can be found for example under - <a href="http://www.vbapi.com/ref/f/filetime.html">http://www.vbapi.com/ref/f/filetime.html</a> - or - <a href="http://www.cs.rpi.edu/courses/fall01/os/FILETIME.html">http://www.cs.rpi.edu/courses/fall01/os/FILETIME.html</a>. In - short: - <em>The FILETIME structure holds a date and time associated with a file. - The structure identifies a 64-bit integer specifying the number of - 100-nanosecond intervals which have passed since January 1, 1601. This - 64-bit value is split into the two dwords stored in the - structure.</em> -</p> - -</li> - - -<li> - -<p align="justify">This documentation origins from the <a href="http://www.rainer-klute.de/~klute/Software/poibrowser/doc/HPSF-Description.html">HPSF description</a> available at <a href="http://www.rainer-klute.de/~klute/Software/poibrowser/doc/HPSF-Description.html">http://www.rainer-klute.de/~klute/Software/poibrowser/doc/HPSF-Description.html</a>.</p> - -</li> - -</ol> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hpsf/todo.html b/build/jakarta-poi/docs/hpsf/todo.html deleted file mode 100644 index 6641d7388d..0000000000 --- a/build/jakarta-poi/docs/hpsf/todo.html +++ /dev/null @@ -1,173 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>To Do</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HPSF</span> -<br> -<a class="s1" href="index.html">Overview</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="internals.html">Internals</a> -<br> -<a class="s1" href="todo.html">To Do</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>To Do</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">To Do</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>To Do</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The following functionalities should be added to HPFS:</p> - - -<ol> - -<li> - -<p align="justify">Complete writing the HPSF documentation.</p> - -</li> - -<li> - -<p align="justify">Add writing capability for property sets.</p> - -</li> - -<li> - -<p align="justify">Add codepage support.</p> - -</li> - -<li> - -<p align="justify">Add Unicode support.</p> - -</li> - -<li> - -<p align="justify">Add resource bundles to - <code>org.apache.poi.hpsf.wellknown</code> to ease - localizations.</p> - -</li> - -<li> - -<p align="justify">Implement reading functionality for those property types that are not - yet supported (other than byte arrays).</p> - -</li> - -</ol> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/alternatives.html b/build/jakarta-poi/docs/hssf/alternatives.html deleted file mode 100644 index 98fbb79007..0000000000 --- a/build/jakarta-poi/docs/hssf/alternatives.html +++ /dev/null @@ -1,230 +0,0 @@ -<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils"> -<head> -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title></title> -<link href="ns4_toxins.css" type="text/css" rel="stylesheet"> -<link href="main.css" type="text/css" rel="stylesheet"> -<link media="print" href="print.css" type="text/css" rel="stylesheet"> -<link href="compact.css" type="text/css" title="compact" rel="alternate stylesheet"> -</head> -<body marginheight="0" marginwidth="0"> -<div id="banner"> -<table width="100%" cellpadding="8" cellspacing="0" border="0"> -<tr> -<td><a href="http://www.apache.org/"><img hspace="0" vspace="0" border="0" src="common/images/group-logo.gif"></a></td><td> -<div align="right"> -<a href="http://www.apache.org/"><img hspace="0" vspace="0" border="0" src="common/images/project-logo.gif"></a> -</div> -</td> -</tr> -</table> -</div> -<div class="modbar"> -<small><strong><a href="http://www.apache.org/">www.apache.org</a> > - <a href="http://www.apache.org/">jakarta.apache.org</a> > - <a href="#"></a></strong></small> -</div> -<table id="main" width="98%" cellpadding="8" cellspacing="0" border="0"> -<tr valign="top"> -<td width="20%" id="leftcol"> -<div id="navcolumn"> -<div> -<small><a href="../index.html">Main</a></small> -</div> -<div> -<small><strong>HSSF</strong></small> -<div> -<small><a href="quick-guide.html">Quick Guide</a></small> -</div> -<div> -<small><a href="how-to.html">HOWTO</a></small> -</div> -<div> -<small><a href="use-case.html">Use Case</a></small> -</div> -<div> -<small><a href="diagrams.html">Pictorial Docs</a></small> -</div> -<div> -<small><a href="alternatives.html">Alternatives</a></small> -</div> -</div> -<div> -<small><strong>Contributer's Guide</strong></small> -<div> -<small><a href="record-generator.html">Record Generator</a></small> -</div> -</div> -</div> -<div id="helptext"> -<table width="100%" cellpadding="3" cellspacing="0" border="0"> -<tr> -<th>How do I...?</th> -</tr> -<tr> -<td> -<div>Learn more about this project? </div> -<div>Print this page...</div> -<div>Troubleshoot...</div> -</td> -</tr> -</table> -</div> -</td><td id="bodycol" width="100%"> -<div id="topmodule"> -<table width="100%" cellpadding="3" cellspacing="0" border="0"> -<tr> -<td nowrap="nowrap"> -<form method="get" action="http://www.google.com/search" onsubmit="q.value = query.value + ' site:jakarta.apache.org'"> -<input type="hidden" name="q"><input maxlength="255" size="35" name="id" id="query" type="text"> - <input type="button" value="Search" name="Search"> - <img border="0" alt="" height="15" width="2" src="images/seperator2.gif"> - <input type="radio" name="web" value="web">web site <input type="radio" name="mail" value="mail">mail lists - </form> -</td> -</tr> -</table> -</div> -<h2>HSSF</h2> -<font color="#525D76"><i>Alternatives to HSSF</i></font> -<br> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="100%"> -<tr> -<td bgcolor="#003063"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Alternatives</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p> - Maybe it's unwise to advertise your competitors but we believe - competition is good and we have the best support reading and - write Excel workbooks currently available. - </p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> - -<tr> - -<td><b>Product</b></td> - <td><b>URL</b></td> - <td><b>Description</b></td> - -</tr> - -<tr> - -<td>Formula One</td> - <td> - <a href="http://www.tidestone.com/">www.tidestone.com</a> - </td> - <td>An alternative to this project is to - buy the $10,000 Formula 1 library - and accept its crude api and limitations.</td> - -</tr> - -<tr> - -<td>Visual Basic</td> - <td> - <a href="http://www.microsoft.com/">www.microsoft.com</a> - </td> - <td>Give up XML and write Visual Basic code on a Microsoft Windows based - Environment or output in Microsoft's beta and primarily undocumented - XML for office format.</td> - -</tr> - -<tr> - -<td>JExcel</td> - <td>http://stareyes.homeip.net:8888</td> - <td>Frequently unavailable. Little currently known about it's capabilities.</td> - -</tr> - -<tr> - -<td>JWorkbook</td> - <td>http://www.object-refinery.com/jworkbook/index.html</td> - <td>This effort supports Gnumeric and Excel, however the Excel part is done using POI anyway.</td> - -</tr> - -<tr> - -<td>xlReader</td> - <td><a href="http://www.sourceforge.net/projects/xlrd">http://www.sourceforge.net/projects/xlrd</a></td> - <td>Provides decent support for reading Excel.</td> - -</tr> - -<tr> - -<td>Excel ODBC Driver</td> - <td><a href="http://www.nwlink.com/~leewal/content/exceljavasample.htm">http://www.nwlink.com/~leewal/content/exceljavasample.htm</a></td> - <td>ODBC offers a somewhat wierd method for using Excel.</td> - -</tr> - -<tr> - -<td>ExtenXLS</td> - <td><a href="http://www.extentech.com/products/ExtenXLS/docs/intro3.jsp">http://www.extentech.com/products/ExtenXLS/docs/intro3.jsp</a></td> - <td>Commercial library for reading, modifying and writing Excel spreadsheets. Not cheap but - certainly a lot more affordable than Formula 1. No idea as to it's quality.</td> - -</tr> - -<tr> - -<td>J-Integra Java-Excel Bridge</td> - <td><a href="http://www.intrinsyc.com/products/bridging/jintegra.asp">http://www.intrinsyc.com/products/bridging/jintegra.asp</a></td> - <td>Uses DCOM to an Excel instance on a windows machine.</td> - -</tr> - -<tr> - -<td>Perl & C</td> - <td>-</td> - <td>There are a number of perl and C libraries, however none of them are consistent.</td> - -</tr> - -</table> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -<div id="footer"> -<table cellpadding="4" cellspacing="0" border="0"> -<tr> -<td><a href="http://www.apache.org/">Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</a></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a><a href="http://jakarta.apache.org/ant/"><img alt="Ant Logo" src="images/ant_logo_medium.gif"></a></td> -</tr> -</table> -</div> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/diagram1.html b/build/jakarta-poi/docs/hssf/diagram1.html deleted file mode 100644 index 1e342014d7..0000000000 --- a/build/jakarta-poi/docs/hssf/diagram1.html +++ /dev/null @@ -1,134 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HSSF</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HSSF</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HSSF</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>Usermodel Class Diagram by Matthew Young</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<img src="images/usermodel.gif"> - </td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/diagrams.html b/build/jakarta-poi/docs/hssf/diagrams.html deleted file mode 100644 index a4fe26df27..0000000000 --- a/build/jakarta-poi/docs/hssf/diagrams.html +++ /dev/null @@ -1,159 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HSSF</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HSSF</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HSSF</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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"> - This section is intended for diagrams (UML/etc) that help - explain HSSF. - </p> - -<ul> - -<li> - -<a href="diagram1.html">HSSF usermodel class diagram</a> - - by Matthew Young (myoung at westernasset dot com) - </li> - -</ul> - -<p align="justify"> - Have more? Add a new "bug" to the bug database with [DOCUMENTATION] - prefacing the description and a link to the file on an http server - somewhere. If you don't have your own webserver, then you can email it - to (acoliver at apache dot org) provided its < 5MB. Diagrams should be - in some format that can be read at least on Linux and Windows. Diagrams - that can be edited are preferrable, but lets face it, there aren't too - many good affordable UML tools yet! And no they don't HAVE to be UML... - just useful. - </p> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/how-to.html b/build/jakarta-poi/docs/hssf/how-to.html deleted file mode 100644 index 37ffa9f763..0000000000 --- a/build/jakarta-poi/docs/hssf/how-to.html +++ /dev/null @@ -1,870 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>The New Halloween Document</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>The New Halloween Document</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">The New Halloween Document</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>How to use the HSSF prototype API</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>Capabilities</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This release of the how-to outlines functionality for 1.5. - Those looking for information on the release edition should - look in the poi-src for the release or at a - previous edition in CVS tagged for that release.</p> - -<p align="justify"> - This release allows numeric and string cell values to be written to - or read from an XLS file as well as reading and writing dates. Also - in this release is row and column sizing, cell styling (bold, - italics, borders,etc), and support for built-in data formats. New - to this release is an event-based API for reading XLS files. - It differs greatly from the read/write API - and is intended for intermediate developers who need a smaller - memory footprint. It will also serve as the basis for the HSSF - Generator.</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>Target Audience</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This release is intended for developers, java-fanatics and the -just generally all around impatient. HSSF has not yet been -extensively tested in a high load multi-threaded situation. This -release is not considered to be "golden" as it has new -features that have not been extensively tested, and is an early 2.0 -build that could be restructured significantly in the future (not -that there are necessarily plans to do so, just that you're better -off basing your code on 1.0 and sticking with it if you don't need -2.0 stuff bad enough to deal with us pulling the rug out from under -you regularly).</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>General Use</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>User API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="97%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-2"><font face="Arial,sans-serif"><b>Writing a new one</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The high level API (package: org.apache.poi.hssf.usermodel) -is what most people should use. Usage is very simple. -</p> - -<p align="justify">Workbooks are created by creating an instance of -org.apache.poi.hssf.usermodel.HSSFWorkbook. -</p> - -<p align="justify">Sheets are created by calling createSheet() from an existing -instance of HSSFWorkbook, the created sheet is automatically added in -sequence to the workbook. Sheets do not in themselves have a sheet -name (the tab at the bottom); you set -the name associated with a sheet by calling -HSSFWorkbook.setSheetName(sheetindex,"SheetName").</p> - -<p align="justify">Rows are created by calling createRow(rowNumber) from an existing -instance of HSSFSheet. Only rows that have cell values should be -added to the sheet. To set the row's height, you just call -setRowHeight(height) on the row object. The height must be given in -twips, or 1/20th of a point. If you prefer, there is also a -setRowHeightInPoints method. -</p> - -<p align="justify">Cells are created by calling createCell(column, type) from an -existing HSSFRow. Only cells that have values should be added to the -row. Cells should have their cell type set to either -HSSFCell.CELL_TYPE_NUMERIC or HSSFCell.CELL_TYPE_STRING depending on -whether they contain a numeric or textual value. Cells must also have -a value set. Set the value by calling setCellValue with either a -String or double as a parameter. Individual cells do not have a -width; you must call setColumnWidth(colindex, width) (use units of -1/256th of a character) on the HSSFSheet object. (You can't do it on -an individual basis in the GUI either).</p> - -<p align="justify">Cells are styled with HSSFCellStyle objects which in turn contain -a reference to an HSSFFont object. These are created via the -HSSFWorkbook object by calling createCellStyle() and createFont(). -Once you create the object you must set its parameters (colors, -borders, etc). To set a font for an HSSFCellStyle call -setFont(fontobj). -</p> - -<p align="justify">Once you have generated your workbook, you can write it out by -calling write(outputStream) from your instance of Workbook, passing -it an OutputStream (for instance, a FileOutputStream or -ServletOutputStream). You must close the OutputStream yourself. HSSF -does not close it for you. -</p> - -<p align="justify">Here is some example code (excerpted and adapted from -org.apache.poi.hssf.dev.HSSF test class):</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> short rownum; - - // create a new file - FileOutputStream out = new FileOutputStream("workbook.xls"); - // create a new workbook - HSSFWorkbook wb = new HSSFWorkbook(); - // create a new sheet - HSSFSheet s = wb.createSheet(); - // declare a row object reference - HSSFRow r = null; - // declare a cell object reference - HSSFCell c = null; - // create 3 cell styles - HSSFCellStyle cs = wb.createCellStyle(); - HSSFCellStyle cs2 = wb.createCellStyle(); - HSSFCellStyle cs3 = wb.createCellStyle(); - // create 2 fonts objects - HSSFFont f = wb.createFont(); - HSSFFont f2 = wb.createFont(); - - //set font 1 to 12 point type - f.setFontHeightInPoints((short) 12); - //make it red - f.setColor((short) HSSFCellStyle.RED); - // make it bold - //arial is the default font - f.setBoldweight(f.BOLDWEIGHT_BOLD); - - //set font 2 to 10 point type - f2.setFontHeightInPoints((short) 10); - //make it the color at palette index 0xf (white) - f2.setColor((short) HSSFCellStyle.WHITE); - //make it bold - f2.setBoldweight(f2.BOLDWEIGHT_BOLD); - - //set cell stlye - cs.setFont(f); - //set the cell format see HSSFDataFromat for a full list - cs.setDataFormat(HSSFDataFormat.getFormat("($#,##0_);[Red]($#,##0)")); - - //set a thin border - cs2.setBorderBottom(cs2.BORDER_THIN); - //fill w fg fill color - cs2.setFillPattern((short) HSSFCellStyle.SOLID_FOREGROUND); - // set foreground fill to red - cs2.setFillForegroundColor((short) HSSFCellStyle.RED); - - // set the font - cs2.setFont(f2); - - // set the sheet name to HSSF Test - wb.setSheetName(0, "HSSF Test"); - // create a sheet with 300 rows (0-299) - for (rownum = (short) 0; rownum < 300; rownum++) - { - // create a row - r = s.createRow(rownum); - // on every other row - if ((rownum % 2) == 0) - { - // make the row height bigger (in twips - 1/20 of a point) - r.setHeight((short) 0x249); - } - - //r.setRowNum(( short ) rownum); - // create 50 cells (0-49) (the += 2 becomes apparent later - for (short cellnum = (short) 0; cellnum < 50; cellnum += 2) - { - // create a numeric cell - c = r.createCell(cellnum); - // do some goofy math to demonstrate decimals - c.setCellValue(rownum * 10000 + cellnum - + (((double) rownum / 1000) - + ((double) cellnum / 10000))); - - // on every other row - if ((rownum % 2) == 0) - { - // set this cell to the first cell style we defined - c.setCellStyle(cs); - } - - // create a string cell (see why += 2 in the - c = r.createCell((short) (cellnum + 1)); - - // set the cell's string value to "TEST" - c.setCellValue("TEST"); - // make this column a bit wider - s.setColumnWidth((short) (cellnum + 1), (short) ((50 * 8) / ((double) 1 / 20))); - - // on every other row - if ((rownum % 2) == 0) - { - // set this to the white on red cell style - // we defined above - c.setCellStyle(cs2); - } - - } - } - - //draw a thick black border on the row at the bottom using BLANKS - // advance 2 rows - rownum++; - rownum++; - - r = s.createRow(rownum); - - // define the third style to be the default - // except with a thick black border at the bottom - cs3.setBorderBottom(cs3.BORDER_THICK); - - //create 50 cells - for (short cellnum = (short) 0; cellnum < 50; cellnum++) - { - //create a blank type cell (no value) - c = r.createCell(cellnum); - // set it to the thick black border style - c.setCellStyle(cs3); - } - - //end draw thick black border - - - // demonstrate adding/naming and deleting a sheet - // create a sheet, set its title then delete it - s = wb.createSheet(); - wb.setSheetName(1, "DeletedSheet"); - wb.removeSheetAt(1); - //end deleted sheet - - // write the workbook to the output stream - // close our file (don't blow out our file handles - wb.write(out); - out.close(); - </pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="97%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-2"><font face="Arial,sans-serif"><b>Reading or modifying an existing file</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">Reading in a file is equally simple. To read in a file, create a -new instance of org.apache.poi.poifs.Filesystem, passing in an open InputStream, such as a FileInputStream -for your XLS, to the constructor. Construct a new instance of -org.apache.poi.hssf.usermodel.HSSFWorkbook passing the -Filesystem instance to the constructor. From there you have access to -all of the high level model objects through their assessor methods -(workbook.getSheet(sheetNum), sheet.getRow(rownum), etc). -</p> - -<p align="justify">Modifying the file you have read in is simple. You retrieve the -object via an assessor method, remove it via a parent object's remove -method (sheet.removeRow(hssfrow)) and create objects just as you -would if creating a new xls. When you are done modifying cells just -call workbook.write(outputstream) just as you did above.</p> - -<p align="justify">An example of this can be seen in -<a href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-poi/src/java/org/apache/poi/hssf/dev/HSSF.java?rev=1.1">org.apache.poi.hssf.dev.HSSF</a>.</p> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Event API</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The event API is brand new. It is intended for intermediate -developers who are willing to learn a little bit of the low level API -structures. Its relatively simple to use, but requires a basic -understanding of the parts of an Excel file (or willingness to -learn). The advantage provided is that you can read an XLS with a -relatively small memory footprint. -</p> - -<p align="justify">To use this API you construct an instance of -org.apache.poi.hssf.eventmodel.HSSFRequest. Register a class you -create that supports the -org.apache.poi.hssf.eventmodel.HSSFListener interface using the -HSSFRequest.addListener(yourlistener, recordsid). The recordsid -should be a static reference number (such as BOFRecord.sid) contained -in the classes in org.apache.poi.hssf.record. The trick is you -have to know what these records are. Alternatively you can call -HSSFRequest.addListenerForAllRecords(mylistener). In order to learn -about these records you can either read all of the javadoc in the -org.apache.poi.hssf.record package or you can just hack up a -copy of org.apache.poi.hssf.dev.EFHSSF and adapt it to your -needs. TODO: better documentation on records.</p> - -<p align="justify">Once you've registered your listeners in the HSSFRequest object -you can construct an instance of -org.apache.poi.poifs.filesystem.FileSystem (see POIFS howto) and -pass it your XLS file inputstream. You can either pass this, along -with the request you constructed, to an instance of HSSFEventFactory -via the HSSFEventFactory.processWorkbookEvents(request, Filesystem) -method, or you can get an instance of DocumentInputStream from -Filesystem.createDocumentInputStream("Workbook") and pass -it to HSSFEventFactory.processEvents(request, inputStream). Once you -make this call, the listeners that you constructed receive calls to -their processRecord(Record) methods with each Record they are -registered to listen for until the file has been completely read. -</p> - -<p align="justify">A code excerpt from org.apache.poi.hssf.dev.EFHSSF (which is -in CVS or the source distribution) is reprinted below with excessive -comments:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -/** - * This example shows how to use the event API for reading a file. - */ -public class EventExample - implements HSSFListener -{ - private SSTRecord sstrec; - - /** - * This method listens for incoming records and handles them as required. - * @param record The record that was found while reading. - */ - public void processRecord(Record record) - { - switch (record.getSid()) - { - // the BOFRecord can represent either the beginning of a sheet or the workbook - case BOFRecord.sid: - BOFRecord bof = (BOFRecord) record; - if (bof.getType() == bof.TYPE_WORKBOOK) - { - System.out.println("Encountered workbook"); - // assigned to the class level member - } else if (bof.getType() == bof.TYPE_WORKSHEET) - { - System.out.println("Encountered sheet reference"); - } - break; - case BoundSheetRecord.sid: - BoundSheetRecord bsr = (BoundSheetRecord) record; - System.out.println("New sheet named: " + bsr.getSheetname()); - break; - case RowRecord.sid: - RowRecord rowrec = (RowRecord) record; - System.out.println("Row found, first column at " - + rowrec.getFirstCol() + " last column at " + rowrec.getLastCol()); - break; - case NumberRecord.sid: - NumberRecord numrec = (NumberRecord) record; - System.out.println("Cell found with value " + numrec.getValue() - + " at row " + numrec.getRow() + " and column " + numrec.getColumn()); - break; - // SSTRecords store a array of unique strings used in Excel. - case SSTRecord.sid: - sstrec = (SSTRecord) record; - for (int k = 0; k < sstrec.getNumUniqueStrings(); k++) - { - System.out.println("String table value " + k + " = " + sstrec.getString(k)); - } - break; - case LabelSSTRecord.sid: - LabelSSTRecord lrec = (LabelSSTRecord) record; - System.out.println("String cell found with value " - + sstrec.getString(lrec.getSSTIndex())); - break; - } - } - - /** - * Read an excel file and spit out what we find. - * - * @param args Expect one argument that is the file to read. - * @throws IOException When there is an error processing the file. - */ - public static void main(String[] args) throws IOException - { - // create a new file input stream with the input file specified - // at the command line - FileInputStream fin = new FileInputStream(args[0]); - // create a new org.apache.poi.poifs.filesystem.Filesystem - POIFSFileSystem poifs = new POIFSFileSystem(fin); - // get the Workbook (excel part) stream in a InputStream - InputStream din = poifs.createDocumentInputStream("Workbook"); - // construct out HSSFRequest object - HSSFRequest req = new HSSFRequest(); - // lazy listen for ALL records with the listener shown above - req.addListenerForAllRecords(new EventExample()); - // create our event factory - HSSFEventFactory factory = new HSSFEventFactory(); - // process our events based on the document input stream - factory.processEvents(req, din); - // once all the events are processed close our file input stream - fin.close(); - // and our document input stream (don't want to leak these!) - din.close(); - System.out.println("done."); - } -} -</pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Low Level APIs</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The low level API is not much to look at. It consists of lots of -"Records" in the org.apache.poi.hssf.record.* package, -and set of helper classes in org.apache.poi.hssf.model.*. The -record classes are consistent with the low level binary structures -inside a BIFF8 file (which is embedded in a POIFS file system). You -probably need the book: "Microsoft Excel 97 Developer's Kit" -from Microsoft Press in order to understand how these fit together -(out of print but easily obtainable from Amazon's used books). In -order to gain a good understanding of how to use the low level APIs -should view the source in org.apache.poi.hssf.usermodel.* and -the classes in org.apache.poi.hssf.model.*. You should read the -documentation for the POIFS libraries as well.</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>HSSF Class/Test Application</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">The HSSF application is nothing more than a test for the high -level API (and indirectly the low level support). The main body of -its code is repeated above. To run it: -</p> - -<ul> - -<li>download the poi-alpha build and untar it (tar xvzf - tarball.tar.gz) - </li> - -<li>set up your classpath as follows: - <code>export HSSFDIR={wherever you put HSSF's jar files} -export LOG4JDIR={wherever you put LOG4J's jar files} -export CLASSPATH=$CLASSPATH:$HSSFDIR/hssf.jar:$HSSFDIR/poi-poifs.jar:$HSSFDIR/poi-util.jar:$LOG4JDIR/jog4j.jar</code> - -</li> -<li>type: - <code>java org.apache.poi.hssf.dev.HSSF ~/myxls.xls write</code> -</li> - -</ul> - -<p align="justify"></p> - -<p align="justify">This should generate a test sheet in your home directory called <code>"myxls.xls"</code>. </p> - -<ul> - -<li>Type: - <code>java org.apache.poi.hssf.dev.HSSF ~/input.xls output.xls</code> - -<p align="justify"> -This is the read/write/modify test. It reads in the spreadsheet, modifies a cell, and writes it back out. -Failing this test is not necessarily a bad thing. If HSSF tries to modify a non-existant sheet then this will -most likely fail. No big deal. </p> -</li> - -</ul> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>HSSF Logging facility</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">HSSF now has a logging facility (using - <a href="http://jakarta.apache.org/commons/logging.html">commons logging</a>) -that will record massive amounts of debugging information. Its mostly -useful to us hssf-developing geeks, but might be useful in tracking -down problems. -</p> - -<p align="justify">So Why use commons logging rather than log4j? Well the following discussion from -the jakarta-general mailing list sums it up pretty well. (Thanks Morgan) -</p> - -<p align="justify"> -<em>Here's the problem, as I see it.</em> - -</p> - -<p align="justify"> -<em>Suppose Commons component A decides to adopt Log4J, Commons component B -decides to adopt LogKit, and Commons component C adopts JDK1.4 logging. -They will all minimally function with the right jars in the classpath. -However you (the end-user) are left with maintaining configuration for 3 -different logging APIs, which is tedious at best. When you take into -account cool features like variable log levels, Log4J appenders and the -like, you're pretty much guaranteed to swallow up useful configuration -options because sophisticated configurations are too difficult to maintain -over mutiple logging implementations.</em> - -</p> - -<p align="justify"> - -<em>Contrarily, if all three Commons components use a logging facade, you can -focus all your configuration efforts on one logging implementation. Sure, -there is a trade-off; you don't have access to all the features, and the -interface between the facade and the implementation must be maintained. But -the benefits are not just political; they potentially make the end-users -configuration much easier.</em> - -</p> - -<p align="justify"> -<em>Even if all Commons components used the same logging implementation (Log4J -for example), other projects in Jakarta-land may choose otherwise. If you -add enough Jakarta projects to your environment, you eventually end up with -the scenario described above. It's a worthwhile effort to attempt a logging -solution that plays well with the Jakarta community at large. I think in -many cases the Commons Logging component can fill that role.</em> - -</p> - -<p align="justify"> -Refer to the commons logging package level javadoc for more information concerning how to -<a href="http://jakarta.apache.org/commons/logging/api/index.html">configure commons logging.</a> - -</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>HSSF Developer's tools</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">HSSF has a number of tools useful for developers to debug/develop -stuff using HSSF (and more generally XLS files). We've already -discussed the app for testing HSSF read/write/modify capabilities; -now we'll talk a bit about BiffViewer. Early on in the development of -HSSF, it was decided that knowing what was in a record, what was -wrong with it, etc. was virtually impossible with the available -tools. So we developed BiffViewer. You can find it at -org.apache.poi.hssf.dev.BiffViewer. It performs two basic -functions and a derivative. -</p> - -<p align="justify">The first is "biffview". To do this you run it (assumes -you have everything setup in your classpath and that you know what -you're doing enough to be thinking about this) with an xls file as a -parameter. It will give you a listing of all understood records with -their data and a list of not-yet-understood records with no data -(because it doesn't know how to interpret them). This listing is -useful for several things. First, you can look at the values and SEE -what is wrong in quasi-English. Second, you can send the output to a -file and compare it. -</p> - -<p align="justify">The second function is "big freakin dump", just pass a -file and a second argument matching "bfd" exactly. This -will just make a big hexdump of the file. -</p> - -<p align="justify">Lastly, there is "mixed" mode which does the same as -regular biffview, only it includes hex dumps of certain records -intertwined. To use that just pass a file with a second argument -matching "on" exactly.</p> - -<p align="justify">In the next release cycle we'll also have something called a -FormulaViewer. The class is already there, but its not very useful -yet. When it does something, we'll document it.</p> - - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>What's Next?</b></font></font></td> -</tr> -<tr> -<td> -<br> - - -<p align="justify">This release contains code that supports "internationalization" -or more accurately non-US/UK languages; however, it has not been -tested with the new API changes (please help us with this). We've -shifted focus a bit for this release in recognition of the -international support we've gotten. We're going to focus on western -European languages for our first beta. We're more than happy to -accept help in supporting non-Western European languages if someone -who knows what they're doing in this area is willing to pitch in! -(There is next to no documentation on what is necessary to support -such a move and its really hard to support a language when you don't even -know the alphabet).</p> - -<p align="justify">This release of HSSF does not yet support Formulas. I've been -focusing on the requests I've gotten in. That being said, if we get -more user feedback on what is most useful first we'll aim for that. -As a general principal, HSSF's goal is to support HSSF-Serializer -(meaning an emphasis on write). We would like to hear from you! How -are you using HSSF/POIFS? How would you like to use it? What features -are most important first? -</p> - -</td> -</tr> -</table> -</div> -<br> - - -</td> -</tr> -</table> -</div> -<br> - - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/images/cocoon2-small.jpg b/build/jakarta-poi/docs/hssf/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/hssf/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/hssf/images/header.gif b/build/jakarta-poi/docs/hssf/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/hssf/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hssf/images/jakarta-logo.gif b/build/jakarta-poi/docs/hssf/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/hssf/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hssf/images/usermodel.gif b/build/jakarta-poi/docs/hssf/images/usermodel.gif Binary files differdeleted file mode 100644 index 4f4c3606c3..0000000000 --- a/build/jakarta-poi/docs/hssf/images/usermodel.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/hssf/index.html b/build/jakarta-poi/docs/hssf/index.html deleted file mode 100644 index ea4d075381..0000000000 --- a/build/jakarta-poi/docs/hssf/index.html +++ /dev/null @@ -1,172 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HSSF</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HSSF</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HSSF</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/quick-guide.html b/build/jakarta-poi/docs/hssf/quick-guide.html deleted file mode 100644 index f053d86d29..0000000000 --- a/build/jakarta-poi/docs/hssf/quick-guide.html +++ /dev/null @@ -1,597 +0,0 @@ -<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils"> -<head> -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title></title> -<link href="ns4_toxins.css" type="text/css" rel="stylesheet"> -<link href="main.css" type="text/css" rel="stylesheet"> -<link media="print" href="print.css" type="text/css" rel="stylesheet"> -<link href="compact.css" type="text/css" title="compact" rel="alternate stylesheet"> -</head> -<body marginheight="0" marginwidth="0"> -<div id="banner"> -<table width="100%" cellpadding="8" cellspacing="0" border="0"> -<tr> -<td><a href="http://www.apache.org/"><img hspace="0" vspace="0" border="0" src="common/images/group-logo.gif"></a></td><td> -<div align="right"> -<a href="http://www.apache.org/"><img hspace="0" vspace="0" border="0" src="common/images/project-logo.gif"></a> -</div> -</td> -</tr> -</table> -</div> -<div class="modbar"> -<small><strong><a href="http://www.apache.org/">www.apache.org</a> > - <a href="http://www.apache.org/">jakarta.apache.org</a> > - <a href="#"></a></strong></small> -</div> -<table id="main" width="98%" cellpadding="8" cellspacing="0" border="0"> -<tr valign="top"> -<td width="20%" id="leftcol"> -<div id="navcolumn"> -<div> -<small><a href="../index.html">Main</a></small> -</div> -<div> -<small><strong>HSSF</strong></small> -<div> -<small><a href="quick-guide.html">Quick Guide</a></small> -</div> -<div> -<small><a href="how-to.html">HOWTO</a></small> -</div> -<div> -<small><a href="use-case.html">Use Case</a></small> -</div> -<div> -<small><a href="diagrams.html">Pictorial Docs</a></small> -</div> -<div> -<small><a href="alternatives.html">Alternatives</a></small> -</div> -</div> -<div> -<small><strong>Contributer's Guide</strong></small> -<div> -<small><a href="record-generator.html">Record Generator</a></small> -</div> -</div> -</div> -<div id="helptext"> -<table width="100%" cellpadding="3" cellspacing="0" border="0"> -<tr> -<th>How do I...?</th> -</tr> -<tr> -<td> -<div>Learn more about this project? </div> -<div>Print this page...</div> -<div>Troubleshoot...</div> -</td> -</tr> -</table> -</div> -</td><td id="bodycol" width="100%"> -<div id="topmodule"> -<table width="100%" cellpadding="3" cellspacing="0" border="0"> -<tr> -<td nowrap="nowrap"> -<form method="get" action="http://www.google.com/search" onsubmit="q.value = query.value + ' site:jakarta.apache.org'"> -<input type="hidden" name="q"><input maxlength="255" size="35" name="id" id="query" type="text"> - <input type="button" value="Search" name="Search"> - <img border="0" alt="" height="15" width="2" src="images/seperator2.gif"> - <input type="radio" name="web" value="web">web site <input type="radio" name="mail" value="mail">mail lists - </form> -</td> -</tr> -</table> -</div> -<h2>Quick Guide to HSSF Features</h2> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="100%"> -<tr> -<td bgcolor="#003063"><font color="#ffffff" size="+1"><font face="Arial,sans-serif"><b>Quick Guide to Features</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p> - Want to use HSSF read and write spreadsheets in a hurry? This guide is for you. If you're after - more in-depth coverage of the HSSF user-API please consult the <a href="how-to.html">HOWTO</a> - guide as it contains actual descriptions of how to use this stuff. - </p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="99%"> -<tr> -<td bgcolor="#003063"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Index of Features</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> -<a href="#NewWorkbook">How to create a new workbook</a> -</li> - -<li> -<a href="#NewSheet">How to create a sheet</a> -</li> - -<li> -<a href="#CreateCells">How to create cells</a> -</li> - -<li> -<a href="#CreateDateCells">How to create date cells</a> -</li> - -<li> -<a href="#CellTypes">Working with different types of cells</a> -</li> - -<li> -<a href="#Alignment">Aligning cells</a> -</li> - -<li> -<a href="#Borders">Working with borders</a> -</li> - -<li> -<a href="#FrillsAndFills">Fills and color</a> -</li> - -<li> -<a href="#MergedCells">Merging cells</a> -</li> - -<li> -<a href="#WorkingWithFonts">Working with fonts</a> -</li> - -<li> -<a href="#ReadWriteWorkbook">Reading and writing</a> -</li> - -</ul> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="99%"> -<tr> -<td bgcolor="#003063"><font color="#ffffff" size="+0"><font face="Arial,sans-serif"><b>Features</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<anchor id="NewWorkbook"></anchor> - -<h4>New Workbook</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="NewSheet"></anchor> - -<h4>New Sheet</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet1 = wb.createSheet("new sheet"); - HSSFSheet sheet2 = wb.createSheet("second sheet"); - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="CreateCells"></anchor> - -<h4>Creating Cells</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - // Create a row and put some cells in it. Rows are 0 based. - HSSFRow row = sheet.createRow((short)0); - // Create a cell and put a value in it. - HSSFCell cell = row.createCell((short)0); - cell.setCellValue(1); - - // Or do it on one line. - row.createCell((short)1).setCellValue(1.2); - row.createCell((short)2).setCellValue("This is a string"); - row.createCell((short)3).setCellValue(true); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="CreateDateCells"></anchor> - -<h4>Creating Date Cells</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - // Create a row and put some cells in it. Rows are 0 based. - HSSFRow row = sheet.createRow((short)0); - - // Create a cell and put a date value in it. The first cell is not styled - // as a date. - HSSFCell cell = row.createCell((short)0); - cell.setCellValue(new Date()); - - // we style the second cell as a date (and time). It is important to - // create a new cell style from the workbook otherwise you can end up - // modifying the built in style and effecting not only this cell but other cells. - HSSFCellStyle cellStyle = wb.createCellStyle(); - cellStyle.setDataFormat(HSSFDataFormat.getFormat("m/d/yy h:mm")); - cell = row.createCell((short)1); - cell.setCellValue(new Date()); - cell.setCellStyle(cellStyle); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="CellTypes"></anchor> - -<h4>Working with different types of cells</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - HSSFRow row = sheet.createRow((short)2); - row.createCell((short) 0).setCellValue(1.1); - row.createCell((short) 1).setCellValue(new Date()); - row.createCell((short) 2).setCellValue("a string"); - row.createCell((short) 3).setCellValue(true); - row.createCell((short) 4).setCellType(HSSFCell.CELL_TYPE_ERROR); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="Alignment"></anchor> - -<h4>Demonstrates various alignment options</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - public static void main(String[] args) - throws IOException - { - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - HSSFRow row = sheet.createRow((short) 2); - createCell(wb, row, (short) 0, HSSFCellStyle.ALIGN_CENTER); - createCell(wb, row, (short) 1, HSSFCellStyle.ALIGN_CENTER_SELECTION); - createCell(wb, row, (short) 2, HSSFCellStyle.ALIGN_FILL); - createCell(wb, row, (short) 3, HSSFCellStyle.ALIGN_GENERAL); - createCell(wb, row, (short) 4, HSSFCellStyle.ALIGN_JUSTIFY); - createCell(wb, row, (short) 5, HSSFCellStyle.ALIGN_LEFT); - createCell(wb, row, (short) 6, HSSFCellStyle.ALIGN_RIGHT); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - - } - - /** - * Creates a cell and aligns it a certain way. - * - * @param wb the workbook - * @param row the row to create the cell in - * @param column the column number to create the cell in - * @param align the alignment for the cell. - */ - private static void createCell(HSSFWorkbook wb, HSSFRow row, short column, short align) - { - HSSFCell cell = row.createCell(column); - cell.setCellValue("Align It"); - HSSFCellStyle cellStyle = wb.createCellStyle(); - cellStyle.setAlignment(align); - cell.setCellStyle(cellStyle); - } - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="Borders"></anchor> - -<h4>Working with borders</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - // Create a row and put some cells in it. Rows are 0 based. - HSSFRow row = sheet.createRow((short) 1); - - // Create a cell and put a value in it. - HSSFCell cell = row.createCell((short) 1); - cell.setCellValue(4); - - // Style the cell with borders all around. - HSSFCellStyle style = wb.createCellStyle(); - style.setBorderBottom(HSSFCellStyle.BORDER_THIN); - style.setBottomBorderColor(HSSFCellStyle.BLACK); - style.setBorderLeft(HSSFCellStyle.BORDER_THIN); - style.setLeftBorderColor(HSSFCellStyle.GREEN); - style.setBorderRight(HSSFCellStyle.BORDER_THIN); - style.setRightBorderColor(HSSFCellStyle.BLUE); - style.setBorderTop(HSSFCellStyle.BORDER_MEDIUM_DASHED); - style.setTopBorderColor(HSSFCellStyle.AUTOMATIC); - cell.setCellStyle(style); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="FillsAndFrills"></anchor> - -<h4>Fills and colors</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - // Create a row and put some cells in it. Rows are 0 based. - HSSFRow row = sheet.createRow((short) 1); - - // Aqua background - HSSFCellStyle style = wb.createCellStyle(); - style.setFillBackgroundColor(HSSFCellStyle.AQUA); - style.setFillPattern(HSSFCellStyle.BIG_SPOTS); - HSSFCell cell = row.createCell((short) 1); - cell.setCellValue("X"); - cell.setCellStyle(style); - - // Orange "foreground", foreground being the fill foreground not the font color. - style = wb.createCellStyle(); - style.setFillForegroundColor(HSSFCellStyle.ORANGE); - style.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); - cell = row.createCell((short) 2); - cell.setCellValue("X"); - cell.setCellStyle(style); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="MergedCells"></anchor> - -<h4>Merging cells</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - HSSFRow row = sheet.createRow((short) 1); - HSSFCell cell = row.createCell((short) 1); - cell.setCellValue("This is a test of merging"); - - sheet.addMergedRegion(new Region(1,(short)1,1,(short)2)); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="WorkingWithFonts"></anchor> - -<h4>Working with fonts</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - HSSFWorkbook wb = new HSSFWorkbook(); - HSSFSheet sheet = wb.createSheet("new sheet"); - - // Create a row and put some cells in it. Rows are 0 based. - HSSFRow row = sheet.createRow((short) 1); - - // Create a new font and alter it. - HSSFFont font = wb.createFont(); - font.setFontHeightInPoints((short)24); - font.setFontName("Courier New"); - font.setItalic(true); - font.setStrikeout(true); - - // Fonts are set into a style so create a new one to use. - HSSFCellStyle style = wb.createCellStyle(); - style.setFont(font); - - // Create a cell and put a value in it. - HSSFCell cell = row.createCell((short) 1); - cell.setCellValue("This is a test of fonts"); - cell.setCellStyle(style); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -<anchor id="ReadWriteWorkbook"></anchor> - -<h4>Reading and Rewriting Workbooks</h4> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> - POIFSFileSystem fs = - new POIFSFileSystem(new FileInputStream("workbook.xls")); - HSSFWorkbook wb = new HSSFWorkbook(fs); - HSSFSheet sheet = wb.getSheetAt(0); - HSSFRow row = sheet.getRow(2); - HSSFCell cell = row.getCell((short)3); - if (cell == null) - cell = row.createCell((short)3); - cell.setCellType(HSSFCell.CELL_TYPE_STRING); - cell.setCellValue("a test"); - - // Write the output to a file - FileOutputStream fileOut = new FileOutputStream("workbook.xls"); - wb.write(fileOut); - fileOut.close(); - </pre> -</td> -</tr> -</table> -</div> - - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -<div id="footer"> -<table cellpadding="4" cellspacing="0" border="0"> -<tr> -<td><a href="http://www.apache.org/">Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</a></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a><a href="http://jakarta.apache.org/ant/"><img alt="Ant Logo" src="images/ant_logo_medium.gif"></a></td> -</tr> -</table> -</div> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/record-generator.html b/build/jakarta-poi/docs/hssf/record-generator.html deleted file mode 100644 index e691284e0c..0000000000 --- a/build/jakarta-poi/docs/hssf/record-generator.html +++ /dev/null @@ -1,321 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Record Generator HOWTO</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Record Generator HOWTO</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Record Generator HOWTO</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>How to Use the Record Generator</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>History</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The record generator was born from frustration with translating - the Excel records to Java classes. Doing this manually is a time - consuming process. It's also very easy to make mistakes. - </p> - -<p align="justify"> - A utility was needed to take the defintition of what a - record looked like and do all the boring stuff. Thus the - record generator was born. - </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>Capabilities</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The record generator takes XML as input and produced the following - output: - <ul> - -<li>A Java file capabile of decoding and encoding the record.</li> - -<li>A test class with provides a fill-in-the-blanks implementation of a test case - for ensuring the record operates as designed.</li> - -</ul> - -</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>Usage</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The record generator is invoked as an Ant target (generate-records). It goes - through looking for all files in src/records/defintitions ending with _record.xml. - It then creates two files; the Java record definition and the Java test case template. - </p> - -<p align="justify"> - The records themselves have the following general layout: - </p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -<record id="0x1032" name="Frame" package="org.apache.poi.hssf.record"> - <description>The frame record indicates whether there is a border - around the displayed text of a chart.</description> - <author>Glen Stampoultzis (glens at apache.org)</author> - <fields> - <field type="int" size="2" name="border type"> - <const name="regular" value="0" description="regular rectangle or no border"/> - <const name="shadow" value="1" description="rectangle with shadow"/> - </field> - <field type="int" size="2" name="options"> - <bit number="0" name="auto size" - description="excel calculates the size automatically if true"/> - <bit number="1" name="auto position" - description="excel calculates the position automatically"/> - </field> - </fields> -</record> - </pre> -</td> -</tr> -</table> -</div> - -<p align="justify"> - Currently the type can be of type int, float or string. The 'int' - type covers bytes, shorts and integers which is selected using a - size of 1, 2 or 4. An additional type called varword is used to - represent a array of word values where the first short is the length - of the array. The string type generation is only partially - implemented. If choosing string you must select a size of 'var'. - </p> - -<p align="justify"> - The Java records are regenerated each time the record generator is - run, however the test stubs are only created if the test stub does - not already exist. What this means is that you may change test - stubs but not the generated records. - </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>How it Works</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The record generation works by taking an XML file and styling it - using XLST. Given that XSLT is a little limited in some ways it was - necessary to add a little Java code to the mix. - </p> - -<p align="justify"> - See record.xsl, record_test.xsl, FieldIterator.java, - RecordUtil.java, RecordGenerator.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>Limitations</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The record generator does not handle all possible record types and - is not ment to. Sometimes it's going to make more sense to generate - the records manually. The main point of this thing is to make the - easy stuff simple. - </p> - -<p align="justify"> - Currently the record generator is optimized to create Excel records. - It could be adapted to create Word records with a little poking - around. - </p> - -<p align="justify"> - Currently the the XSL file that generates the record calls out to - Java objects. This would have been better done as Javascript inside - the XSL file itself. The Java code for the record generation is - currently quite messy with minimal comments. - </p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/hssf/use-case.html b/build/jakarta-poi/docs/hssf/use-case.html deleted file mode 100644 index a8548ee287..0000000000 --- a/build/jakarta-poi/docs/hssf/use-case.html +++ /dev/null @@ -1,520 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>HSSF Use Cases</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">HSSF</span> -<br> -<a class="s1" href="quick-guide.html">Quick Guide</a> -<br> -<a class="s1" href="how-to.html">HOWTO</a> -<br> -<a class="s1" href="use-case.html">Use Case</a> -<br> -<a class="s1" href="diagrams.html">Pictorial Docs</a> -<br> -<a class="s1" href="alternatives.html">Alternatives</a> -<br> -<br> -<span class="s1">Contributer's Guide</span> -<br> -<a class="s1" href="record-generator.html">Record Generator</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>HSSF Use Cases</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">HSSF Use Cases</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/images/built-with-cocoon.gif b/build/jakarta-poi/docs/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/images/cocoon2-small.jpg b/build/jakarta-poi/docs/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/images/header.gif b/build/jakarta-poi/docs/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/images/jakarta-logo.gif b/build/jakarta-poi/docs/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/images/update.jpg b/build/jakarta-poi/docs/images/update.jpg Binary files differdeleted file mode 100644 index 586a4527e3..0000000000 --- a/build/jakarta-poi/docs/images/update.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/index.html b/build/jakarta-poi/docs/index.html deleted file mode 100644 index 73cc87acb3..0000000000 --- a/build/jakarta-poi/docs/index.html +++ /dev/null @@ -1,471 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>Logo Contest</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The POI committers have voted to - <a href="http://jakarta.apache.org/ant">"innovate"</a> and hold a - logo contest. The big P at the top of the page is just a placeholder. - So the rules are pretty much this: - </p> - -<ul> - -<li> - -<a href="http://burnallgifs.org/">Only PNG submissions</a> - be accepted (we can convert them as needed). - </li> - -<li> - Submissions must be sent to the <a href="http://jakarta.apache.org/site/mail.html">POI - User's mailing list</a> via an http link. If you do not - have an available webserver contact Andy (acoliver at apache dot - org) and ask him to post it for you (and he will if it doesn't - suck royally). Large binary attachments annoyingly posted to - the list will be rebuked. :-) - </li> - -<li> - Image authors must be willing to work with us on any font and - sizing issues, etc. - </li> - -<li> - All submissions become property of the Apache Software - Foundation to do whatever it wants with them (thanks!). - </li> - -<li> - A non-binding poll will be taken and everyone can vote. - </li> - -<li> - Based on the poll results and the fact that Andy won't vote for - anything that isn't some kind of tiki god or hawaiian theme - (maybe a poi pounder would be acceptable), the committers will - vote on the new POI logo. - </li> - -<li> - Logos should be submitted in two flavors: one for the top of the - page and another for posting on other sites that note projects - that use POI technology. - </li> - -<li> - The winner will get credit posted somewhere on the POI site and - have their logo used wherever POI is proudly served. - </li> - -</ul> - -<p align="justify"> - You can see the current submissions <a href="news/logocontest.html">here.</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>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> - -<p align="justify">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.</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>POIFS (POI Filesystem)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">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.</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 (Horrible Spreadsheet Format)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">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.</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 (Horrible Document Format)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">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!</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>HPSF (Horrible Property Set Format)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">HPSF is our port of the OLE 2 property set format to pure - Java. Property sets are mostly use to store a document's properties - (title, author, date of last modification etc.), but they can be used - for application-specific purposes as well. Currently HPSF supports - read functionality only. Please see <a href="hpsf/index.html">the HPSF project page</a> for more - information.</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>What happened to the HSSF Serializer?</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">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.</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>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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/inthenews.html b/build/jakarta-poi/docs/inthenews.html deleted file mode 100644 index 6b859afe4c..0000000000 --- a/build/jakarta-poi/docs/inthenews.html +++ /dev/null @@ -1,365 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 in the news</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - These are articles/etc. posted about POI around the web. If you - see POI in the news or mentioned at least somewhat prominently - on a site (not your homepage that you put the work POI on in - order to get us to link you and by the why here is a picture of - your wife in kids) then send a patch to the list. In general - equal time will be given so please feel free to send inflamatory - defamation as well as favorable, technical and factual. Really - stupid things won't be mentioned (sorry). - </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>English</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - -<a href="http://www.need-a-cake.com/categories/cocoonWeblog/2002/03/07.html"> - Nicola announces POI serialization code - </a> - Matthew Langham's Radio Weblog - </li> - -<li> - -<a href="http://javalobby.org/discussionContext/showThreaded/frm/javalobby?folderId=20&discussionContextId=11523"> - Jakarta POI 1.4583 Released</a> - JavaLobby - </li> - -<li> - -<a href="http://javalobby.org/discussionContext/showThreaded/frm/javalobby?discussionContextId=11442&folderId=20"> - POI project moves to Jakarta (OLE 2 CDF/Excel/Word in - pure java)</a> - JavaLobby - </li> - -<li> - -<a href="http://www.geocities.com/marcoschmidt.geo/java-image-coding.html"> - List of Java libraries to read and write image and document files - </a> Marco Schmidt's homepage (normally we wouldn't - feature someone's homepage but its an extensive list of - information including "alternatives to POI" (for those - of you who are very wealthy). But heck I think I'll - bookmark his page for myself since he's like got every - piece of info known to man linked or featured on it! - </li> - -<li> - -<a href="http://radio.weblogs.com/0101350/"> - The Experiences of an Operator (Måns af Klercker) - </a> - radio.weblogs.com - </li> - -<li> - -<a href="http://dataconv.org/apps_office.html"> - DATACONV - Data Conversion Tools: Office - </a> DATACONV - </li> - -<li> - -<a href="http://chicago.sourceforge.net/devel/"> - Chicago Developer Page - </a> - -</li> - -<li> - -<a href="http://www.onjava.com/pub/d/1157"> - POI/POI Serialization Project - </a> - Man you know you've hit the bigtime when - O'Reilly Likes you.. ;-) - </li> - -<li> - -<a href="http://www.javaworld.com/netnews/index.shtml"> - News Around the Net - </a> - Java World - </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>Deutsch (German)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - -<a href="http://www.entwickler.com/news/2002/02/5718/news.shtml"> - Neues Apache-Projekt bringt Word- und Excel nach Java - </a> - entwickler.com - </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>Español (Spanish)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - -<a href="http://www.javahispano.com/noticias/todas.jsp"> - OLE2 desde Java nativo - </a> - javaHispano - </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>Francais (French)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - -<a href="http://linuxfr.org/section/D%E9veloppeur,0,1,8,0.html"> - Excel/OLE accessibles - </a> - Da Linux French Page - </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>Nihongo (Japanese)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - -<a href="http://www.gimlay.org/~andoh/java/javanew.html"> - What's new with java? - </a> - gimlay.org - </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>No freaking idea</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - If you can read one of these languages, send mail to the list - telling us what language it is and we'll categorize it! - </p> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/livesites.html b/build/jakarta-poi/docs/livesites.html deleted file mode 100644 index f6e4b8684b..0000000000 --- a/build/jakarta-poi/docs/livesites.html +++ /dev/null @@ -1,181 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Live Sites using Poi</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Live Sites using Poi</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Live Sites using Poi</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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">Currently we don't have any sites listed that use Poi, but we're sure they're out there. - Help us change this. If you've - written a site that utilises Poi let us know. - </p> - <!-- - <ul> - <li><link href=""></link></li> - </ul> - </s1> - --> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/mail-archives.html b/build/jakarta-poi/docs/mail-archives.html deleted file mode 100644 index 8e1916bca4..0000000000 --- a/build/jakarta-poi/docs/mail-archives.html +++ /dev/null @@ -1,200 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Mail Archives</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Mail Archives</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Mail Archives</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/mail-lists.html b/build/jakarta-poi/docs/mail-lists.html deleted file mode 100644 index 0407222193..0000000000 --- a/build/jakarta-poi/docs/mail-lists.html +++ /dev/null @@ -1,320 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Mailing Lists</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Mailing Lists</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Mailing Lists</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/news/images/built-with-cocoon.gif b/build/jakarta-poi/docs/news/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/news/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/built-with-cocoon.png b/build/jakarta-poi/docs/news/images/built-with-cocoon.png Binary files differdeleted file mode 100644 index 64e25d3bbf..0000000000 --- a/build/jakarta-poi/docs/news/images/built-with-cocoon.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/header.gif b/build/jakarta-poi/docs/news/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/news/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/jakarta-logo.gif b/build/jakarta-poi/docs/news/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/news/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/news/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/news/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/krysalis-compatible.png b/build/jakarta-poi/docs/news/images/krysalis-compatible.png Binary files differdeleted file mode 100644 index 589305e604..0000000000 --- a/build/jakarta-poi/docs/news/images/krysalis-compatible.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoGlenStampoutlzis.png b/build/jakarta-poi/docs/news/images/logoGlenStampoutlzis.png Binary files differdeleted file mode 100644 index f7707c7f27..0000000000 --- a/build/jakarta-poi/docs/news/images/logoGlenStampoutlzis.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoGustafsson1.png b/build/jakarta-poi/docs/news/images/logoGustafsson1.png Binary files differdeleted file mode 100644 index ff13834ff5..0000000000 --- a/build/jakarta-poi/docs/news/images/logoGustafsson1.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoGustafsson2.png b/build/jakarta-poi/docs/news/images/logoGustafsson2.png Binary files differdeleted file mode 100644 index a3f5c86d24..0000000000 --- a/build/jakarta-poi/docs/news/images/logoGustafsson2.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoLoicLefevre.png b/build/jakarta-poi/docs/news/images/logoLoicLefevre.png Binary files differdeleted file mode 100644 index 520840dff7..0000000000 --- a/build/jakarta-poi/docs/news/images/logoLoicLefevre.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoLoicLefevre2.png b/build/jakarta-poi/docs/news/images/logoLoicLefevre2.png Binary files differdeleted file mode 100644 index ce8efa3113..0000000000 --- a/build/jakarta-poi/docs/news/images/logoLoicLefevre2.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/images/logoMichaelMosmann.png b/build/jakarta-poi/docs/news/images/logoMichaelMosmann.png Binary files differdeleted file mode 100644 index 08424c7bf8..0000000000 --- a/build/jakarta-poi/docs/news/images/logoMichaelMosmann.png +++ /dev/null diff --git a/build/jakarta-poi/docs/news/logocontest.html b/build/jakarta-poi/docs/news/logocontest.html deleted file mode 100644 index 90d55ad755..0000000000 --- a/build/jakarta-poi/docs/news/logocontest.html +++ /dev/null @@ -1,181 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">News</span> -<br> -<a class="s1" href="logocontest.html">Logo Submissions</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 logos</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Here are the current logo submissions. Thanks to the artists! - </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>Michael Mosmann</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - -<img src="images/logoMichaelMosmann.png"> - </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>Loïc Lefèvre</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - -<img src="images/logoLoicLefevre.png"> - <img src="images/logoLoicLefevre2.png"> - </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>Glen Stampoultzis</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - -<img src="images/logoGlenStampoutlzis.png"> - </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>Marcus Gustafsson</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - -<img src="images/logoGustafsson1.png"> - <img src="images/logoGustafsson2.png"> - </p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/overview.html b/build/jakarta-poi/docs/overview.html deleted file mode 100644 index 9af14a038b..0000000000 --- a/build/jakarta-poi/docs/overview.html +++ /dev/null @@ -1,307 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Overview</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Overview</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Overview</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>HPSF</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - -<a href="hpsf/index.html">HPSF</a> is the set of APIs - for reading property sets 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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/plan/POI10Vision.html b/build/jakarta-poi/docs/plan/POI10Vision.html deleted file mode 100644 index 40f7547167..0000000000 --- a/build/jakarta-poi/docs/plan/POI10Vision.html +++ /dev/null @@ -1,1142 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>POI 1.0 Vision Document</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">Planning Documents</span> -<br> -<a class="s1" href="POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="POI20Vision.html">2.0 Vision</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>POI 1.0 Vision Document</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">POI 1.0 Vision Document</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>Preface</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - (21-Jan-02) While this document is just full of useful project - introductory information and I do suggest those interested in getting - involved in the project read it, it is woefully out of date. - </p> - -<p align="justify"> - We deliberately allowed this document to run out of date because it - is a good reflection of what the original vision was for POI 1.0. - You'll note that some of the terminology is not used in quite the same - way any longer. I've made some minor corrections where reading this - confused me. An example: in some places this document may refer to - POI API instead of POIFS API. When this vision was written we had - an incomplete understanding of the project. - </p> - -<p align="justify"> - Lastly, the scope of the project expanded dramatically near the end - of the 1.0 cycle. Our vision at the time was to focus merely on the - Excel port (having no idea how the project would grow or be received) - and provide the OLE 2 Compound Document port for others to port later - formats. We now plan to spearhead these ports under the umbrella of - the POI project. So, you've been warned. Read on, but just realize - that we had a fuzzy view of things to come, and hindsight is 20-20. - </p> - -<p align="justify"> - If I recall major holes were: a complete understanding of the format - of OLE 2 Compound Document format, Excel file format, and exactly how - Cocoon 2 Serializers worked. (that just about covers the whole range - huh?) - </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>1. Introduction</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>1.1 Purpose of this document</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The purpose of this document is to - collect, analyze and define high-level requirements, user needs and - features of the HSSF Serializer for Cocoon 2 and related libraries. - The HSSF Serializer is a java class supporting the Serializer - interface from the Cocoon 2 project and outputting in a compatible - format of that used by the spreadsheet program Microsoft Excel '97. - The HSSF Serializer will be responsible for converting XML - spreadsheet-like documents into Excel-compatible XLS spreadsheets. - </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>1.2 Project Overview</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Many web apps today hit a brick wall - when it comes to the user request that they be able to easily - manipulate their reports and data extracts in the popular Microsoft - Excel spreadsheet format. This often causes inferior technologies to be - chosen for the project simply because they easily support this - format. This project seeks to extend existing XML, Java and Apache - Cocoon 2 project technologies by: - </p> - - -<ul> - -<li> - providing an extensible library - (POIFS) which reads/writes in a compatable format to OLE 2 Compound - Document Format (aka Structured Storage Format) for easy - implementation of other document types; - </li> - -<li> - providing a library (HSSF) for - manipulating spreadsheet data and outputting it in a compatible - format to Microsoft Excel XLS format; - </li> - -<li> - and providing a Cocoon 2 - Serializer (HSSFSerializer) for serializing XML documents as - Excel-compatible spreadsheets. - </li> - -</ul> - - -</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>2. User Description</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>2.1 User/Market Demographics</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - There are a number of enthusiastic - users of XML, UNIX and Java technology. Secondly, the Microsoft - solution for outputting Office Document formats often involves - actually manipulating the software as an OLE Server. This method - provides extremely low performance, extremely high overhead and is - only capable of handling one document at a time. - </p> - -<ol> - -<li> - Our intended audience for the HSSF - Serializer portion of this project are developers writing reports or - data extracts in XML format. - </li> - -<li> - Our intended audience for the HSSF - library portion of this project is ourselves as we are developing - the Serializer and anyone who needs to write to Excel spreadsheets - in a non-XML Java environment or who has specific needs not - addressed by the Serializer. - </li> - -<li> - Our intended audience for the - "POIFS" OLE 2 Compound Document format reader/writer is - ourselves as we are writing the HSSF library and secondly, anyone - wishing to provide other libraries for reading/writing OLE 2 - Compound Document Format in Java. - </li> - -</ol> - -</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>2.2. User environment</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The users of this software shall be - developers in a Java environment on any Operating System or power - users who are capable of XML document generation/deployment. - </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>2.3. Key User Needs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The OLE 2 Compound Document format is - undocumented for all practical purposes and cryptic for all - impractical purposes. Developer needs in this area include - documentation and an easy to use library for reading and writing in - this format without requiring the developer to have intimate - knowledge of the format. - </p> - -<p align="justify"> - There is currently no good way to write - to Microsoft Excel documents from Java or from a non-Microsoft - Windows based platform for that matter. Developers need an easy to - use library that supports a reasonable feature set and allows - seperation of data from formatting/stylistic concerns. - </p> - -<p align="justify"> - There is currently no good way to - transform XML data to Microsoft Excel. Apache's Cocoon 2 project - supplies a complete framework for XML, but nothing for outputting in - Excel's XLS format. Developers and power users alike need a simple - method to output XML documents to Excel through server-side - processing. - </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>2.4. Alternatives and Competition</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Originally there weren't any decent <a href="../hssf/alternatives.html">alternatives</a> for reading or writing - to Excel. This has changed somewhat. - </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>3. Project Overview</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>3.1. Project Perspective</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The produced code shall be licensed by - the Apache License as used by the Cocoon 2 project and maintained on - a project page until such time as the Cocoon 2 developers accept it - as a donation (at which time the copyright will be turned over to - them). - </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>3.2. Project Position Statement</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - For developers on a Java and/or XML - environment this project will provide all the tools necessary for - outputting XML data in the Microsoft Excel format. This project seeks - to make the use of Microsoft Windows based servers unnecessary for - file format considerations and to fully document the OLE 2 Compound - Document format. The project aims not only to provide the tools for - serializing XML to Excel's file format and the tools for writing to - that file format from Java, but also to provide the tools for later - projects to convert other OLE 2 Compound Document formats to pure - Java APIs. - </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>3.3. Summary of Capabilities</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - HSSF Serializer for Apache Cocoon 2 - </p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Benefit - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Supporting Features - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Standard XML tag language for sheet data - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Serializer will transform documents utilizing a defined tag - language - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Utilize XML to output in Excel - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Serializer will output in Excel - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Java API to output in Excel on any platform - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - The project will develop an API that outputs in Excel using - pure Java. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Make it easy for developers to port other OLE 2 Compound - Document-based formats to Java. - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - The POIFS library will contain both a high-level abstraction - along with low-level constructs. The project will fully document - the OLE 2 Compound Document Format. - </font></td> - -</tr> -</table> - -</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>3.4. Assumptions and Dependencies</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - The HSSF Serializer will run on - any Java 2 supporting platform with Apache Cocoon 2 installed along - with the HSSF and POIFS APIs. - </li> - -<li> - The HSSF API requires a Java 2 - implementation and the POI API. - </li> - -<li> - The POIFS API requires a Java 2 - implementation. - </li> - -</ul> - -</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>4. Project Features</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The POIFS API will include: - </p> - -<ul> - -<li> - Low level structures representing - the structures in a POI filesystems. - </li> - -<li> - A low-level API for - creating/manipulating POI filesystems. - </li> - -<li> - A set of high level interfaces - abstracting the user from the POI filesystem constructs and - representing it as a standard filesystem (Files, directories, etc) - </li> - -</ul> - -<p align="justify"> - The HSSF API will include: - </p> - -<ul> - -<li> - Low level structures representing - the structures in an Excel file. - </li> - -<li> - A low-level API for creating and - manipulating Excel files and writing them into POI filesystems. - </li> - -<li> - A high level model and style - interface for manipulating spreadsheet data without knowing anything - about the Excel format itself. - </li> - -</ul> - -<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>4.1 POI Filesystem API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The POI Filesystem API includes: - </p> - -<ul> - -<li>An implementation of Big Blocks</li> - -<li>An implementation of Small Blocks</li> - -<li>An implementation of Header Blocks</li> - -<li>An implementation of Block Allocation Tables</li> - -<li>An implementation of Property Sets</li> - -<li>An implementation of the POI - filesystem including functions to get and set the above constructs; - compound functions for reading/writing files/directories. - </li> - -<li>An abstraction of the POI - filesystem providing interfaces representing Files, Directories, - FileSystems in normal terminology and encapulating the above - constructs. - </li> - -<li>Full documentation of the POI file - format. - </li> - -<li>Full documentation of the APIs and - interfaces provided through Javadoc, user documentation (aimed at - developers using the APIs) - </li> - -<li>Examples aimed at teaching the - user to write code using POI. (titled: recipes for POI) - </li> - -<li>Performance specifications. - (Example POI filesystems rated by some measure of complexity along - with system specifications and execution times for given operations) - </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>4.2 HSSF API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF API includes: - </p> - -<ul> - -<li>An implementation of Record - (binary 2 byte type followed by 2 byte size (n) followed by n bytes)</li> - -<li>Implementations of many standard - record types mapping the data bytes to fields along with methods to - reserialize those fields</li> - -<li>An implementation of the HSSF File - including functions to get/set the above constructs, create a blank - file with the minimum required record types and mappings between - getting/setting data and style in a workbook to the creation of - record types, and read HSSF files.</li> - -<li>An abstraction of the HSSF file - format providing interfaces representing the HSSF File, HSSF - Workbook, HSSF Sheet, HSSF Column, HSSF Formulas in a manner - seperating the data from the styling and encapsulating the above - constructs.</li> - -<li>Full documentation of the HSSF - file format (which will be a subset of the Excel '97 File format). - This must be done with care for legal reasons.</li> - -<li>Full documentation of the APIs and - interfaces provided through Javadoc, user documentation (aimed at - developers using the apis).</li> - -<li>Examples aimed at teaching - developers to use the APIs. - </li> - -<li>Performance specifications. - (Example files rated by some measure of complexity along with system - specifications and execution times for given operations - possibly - the same files used for POI's tests)</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>4.3 HSSF Serializer</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF Serializer subproject: - </p> - -<ul> - -<li>A class supporting the Cocoon 2 - Serializer Interface.</li> - -<li>An interface between the SAX - events and the HSSF APIs.</li> - -<li>A specified tag language for using - with the Serializer.</li> - -<li>Documentation on the tag language - for the HSSF Serializer</li> - -<li>Normal javadocs.</li> - -<li>Example XML files</li> - -<li>Performance specifications. - (Example XML docs and stylesheets rated by some measure of - complexity along with system specifications and execution times)</li> - -</ul> - -</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>5. Other Product Requirements</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>5.1. Applicable Standards</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - All Java code will be 100% pure 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>5.2. System Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The minimum system requirements for POIFS are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -</ul> - -<p align="justify"> - The minimum system requirements for HSSF are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -<li>POIFS API</li> - -</ul> - -<p align="justify"> - The minimum system requirements for the HSSF Serializer are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -<li>Cocoon 2</li> - -<li>HSSF API</li> - -<li>POI API</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>5.3. Performance Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - All components must perform well enough - to be practical for use in a webserver environment (especially - Cocoon2/Tomcat/Apache combo) - </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>5.4. Environmental Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The software will run primarily in - developer environments. We should make some allowances for - not-highly-technical users to write XML documents for the HSSF - Serializer. All other components will assume intermediate Java 2 - knowledge. No XML knowledge will be required except for using the - HSSF Serializer. As much documentation as is practical shall be - required for all components as XML is relatively new, and the - concepts introduced for writing spreadsheets and to POI filesystems - will be brand new to Java and many Java developers. - </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>6. Documentation Requirements</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>6.1 POI Filesystem</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The filesystem as read and written by - POI shall be fully documented and explained so that the average Java - developer can understand it. - </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>6.2. POI API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The POI API will be fully documented - through Javadoc. A walkthrough of using the high level POI API shall - be provided. No documentation outside of the Javadoc shall be - provided for the low-level POI APIs. - </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>6.3. HSSF File Format</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF File Format as implemented by - the HSSF API will be fully documented. No documentation will be - provided for features that are not supported by HSSF API that are - supported by the Excel 97 File Format. Care will be taken not to - infringe on any "legal stuff". - </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>6.4. HSSF API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF API will be documented by - javadoc. A walkthrough of using the high level HSSF API shall be - provided. No documentation outside of the Javadoc shall be provided - for the low level HSSF APIs. - </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>6.5. HSSF Serializer</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF Serializer will be documented - by javadoc. - </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>6.6 HSSF Serializer Tag language</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The XML tag language along with - function and usage shall be fully documented. Examples will be - provided as well. - </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>7. Terminology</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>7.1 Filesystem</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - filesystem shall refer only to the POI formatted archive. - </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>7.2 File</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - file shall refer to the embedded data stream within a - POI filesystem. This will be the actual embedded document. - </p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/plan/POI20Vision.html b/build/jakarta-poi/docs/plan/POI20Vision.html deleted file mode 100644 index aa0e1f7010..0000000000 --- a/build/jakarta-poi/docs/plan/POI20Vision.html +++ /dev/null @@ -1,1214 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>POI 2.0 Vision Document</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">Planning Documents</span> -<br> -<a class="s1" href="POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="POI20Vision.html">2.0 Vision</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>POI 2.0 Vision Document</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">POI 2.0 Vision Document</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>Preface</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - This is the POI 2.0 cycle vision document. Although the vision - has not changed and this document is certainly not out of date and - the vision has not changed, the structure of the project has - changed a bit. We're not going to change the vision document to - reflect this (however proper that may be) because it would only - involve deletion. There is no purpose in providing less - information provided we give clarification. - </p> - -<p align="justify"> - This document was created before the POI components for - <a href="http://xml.apache.org/cocoon">Apache Cocoon</a> - were accepted into the Cocoon project itself. It was also - written before POI was accepted into Jakarta. So while the - vision hasn't changed some of the components are actually now - part of other projects. We'll still be working on them on the - same timeline roughly (minus the overhead of coordination with - other groups), but they are no longer technically part of the - POI project itself. - </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>1. Introduction</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>1.1 Purpose of this document</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The purpose of this document is to - collect, analyze and define high-level requirements, user needs, - and features of the second release of the POI project software. - The POI project currently consists of the following components: - the HSSF Serializer, the HSSF library and the POIFS library. - </p> - -<ul> - -<li> - The HSSF Serializer is a set of Java classes whose main - class supports the Serializer interface from the Cocoon - 2 project and outputs the serialized data in a format - compatible with the spreadsheet program Microsoft Excel - '97. - </li> - -<li> - The HSSF library is a set of classes for reading and - writing Microsoft Excel 97 file format using pure Java. - </li> - -<li> - The POIFS library is a set of classes for reading and - writing Microsoft's OLE 2 Compound Document format using - pure Java. - </li> - -</ul> - -<p align="justify">By the completion of this release cycle the POI project will also - include the HSSF Generator and the HDF library. - </p> - -<ul> - -<li>The HSSF Generator will be responsible for using HSSF to read - in the XLS (Excel 97) file format and create SAX events. The HSSF - Generator will support the applicable interfaces specified by the - Apache Cocoon 2 project. - </li> - -<li>The HDF library will provide a set of high level interfaces - for reading and writing Microsoft Word 97 file format using pure - Java.</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>1.2 Project Overview</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The first release of the POI project - was an astounding success. This release seeks to build on that - success by: - </p> - -<ul> - -<li> - Refactoring POIFS into imput and - output classes as well as an event-driven API for reading. - </li> - -<li> - Refactor HSSF for greater - performance as well as an event-driven API for reading - </li> - -<li> - Extend HSSF by adding the ability to read and write formulas. - </li> - -<li> - Extend HSSF by adding the ability to read and write - user-defined styles. - </li> - -<li> - Create a Cocoon 2 Generator for HSSF using the same tags - as the HSSF Serializer. - </li> - -<li> - Create a new library (HDF) for reading and writing - Microsoft Word DOC format. - </li> - -<li> - Refactor the HSSFSerializer into a separate extensible - POIFSSerializer and HSSFSerializer - </li> - -<li> - Providing the create excel charts. (write only) - </li> - -</ul> - -</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>2. User Description</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>2.1 User/Market Demographics</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - There are a number of enthusiastic - users of XML, UNIX and Java technology. Furthermore, the Microsoft - solution for outputting Office Document formats often involves - actually manipulating the software as an OLE Server. This method - provides extremely low performance, extremely high overhead and is - only capable of handing one document at a time. - </p> - -<ol> - -<li> - Our intended audience for the HSSF - Serializer portion of this project are developers writing reports or - data extracts in XML format. - </li> - -<li> - Our intended audience for the HSSF - library portion of this project is ourselves as we are developing - the HSSF serializer and anyone who needs to read and write Excel - spreadsheets in a non-XML Java environment, or who has specific - needs not addressed by the Serializer - </li> - -<li> - Our intended audience for the - POIFS library is ourselves as we are developing the HSSF and HDF - libraries and anyone wishing to provide other libraries for - reading/writing other file formats utilizing the OLE 2 Compound - Document Format in Java. - </li> - -<li> - Our intended audience for the HSSF - generator are developers who need to export Excel spreadsheets to - XML in a non-proprietary environment. - </li> - -<li> - Our intended audience for the HDF - library is ourselves, as we will be developing a HDF Serializer in a - later release, and anyone wishing to add .DOC file processing and - creation to their projects. - </li> - -</ol> - -</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>2.2. User environment</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The users of this software shall be - developers in a Java environment on any operating system, or power - users who are capable of XML document generation/deployment. - </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>2.3. Key User Needs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF library currently requires a - full object representation to be created before reading values. This - results in very high memory utilization. We need to reduce this - substantially for reading. It would be preferable to do this for - writing, but it may not be possible due to the constraints imposed by - the file format itself. Memory utilization during read is our top - user complaint. - </p> - -<p align="justify"> - The POIFS library currently requires a - full object representation to be created before reading values. This - results in very high memory utilization. We need to reduce this - substantially for reading. - </p> - -<p align="justify"> - The HSSF library currently ignores - formula cells and identifies them as "UnknownRecord" at the - lower level of the API. We must provide a way to read and write - formulas. This is now the top requested feature. - </p> - -<p align="justify"> - The HSSF library currently does not support - charts. This is a key requirement of some users who wish to use HSSF - in a reporting engine. - </p> - -<p align="justify"> - The HSSF Serializer currently does not - provide serialization for cell styling. User's will want stylish - spreadsheets to result from their XML. - </p> - -<p align="justify"> - There is currently no way to generate - the XML from an XLS that is consistent with the format used by the - HSSF Serializer. - </p> - -<p align="justify"> - There should be a way to read and write - the DOC file format using pure 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>2.4. Alternatives and Competition</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Originally there weren't any decent <a href="../hssf/alternatives.html">alternatives</a> for reading or writing - to Excel. This has changed somewhat. - </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>3. Project Overview</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>3.1. Project Perspective</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The produced code shall be licensed by - the Apache License as used by the Cocoon 2 project (APL 1.1) and - maintained on at <a href="http://poi.sourceforge.net/">http://poi.sourceforge.net</a> - and <a href="http://sourcefoge.net/projects/poi">http://sourcefoge.net/projects/poi</a>. - It is our hope to at some point integrate with the various Apache - projects (xml.apache.org and jakarta.apache.org), at which point we'd - turn the copyright over to them. - </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>3.2. Project Position Statement</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - For developers on a Java and/or XML - environment this project will provide all the tools necessary for - outputting XML data in the Microsoft Excel format. This project seeks - to make the use of Microsoft Windows based servers unnecessary for - file format considerations and to fully document the OLE 2 Compound - Document format. The project aims not only to provide the tools for - serializing XML to Excel and Word file formats and the tools for - writing to those file formats from Java, but also to provide the - tools for later projects to convert other OLE 2 Compound Document - formats to pure Java APIs. - </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>3.3. Summary of Capabilities</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - HSSF Serializer for Apache Cocoon 2 - </p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - <b>Benefit</b> - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - <b>Supporting Features</b> - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Ability to serialize styles from XML spreadsheets. - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - HSSFSerialzier will support styles. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Ability to read and write formulas in XLS files. - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - HSSF will support reading/writing formulas. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Ability to output in MS Word on any platform using Java. - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - The project will develop an API that outputs in Word format - using pure Java. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Enhance performance for reading and writing XLS files. - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - HSSF will undergo a number of performance enhancements. HSSF - will include a new event-based API for reading XLS files. POIFS - will support a new event-based API for reading OLE2 CDF files. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - Ability to generate XML from XLS files - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - The project will develop an HSSF Generator. - </font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - The ability to generate charts - </font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - HSSF will provide low level support for chart records as well - as high level API support for generating charts. The ability - to read chart information will not initially be provided. - </font></td> - -</tr> -</table> - -</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>3.4. Assumptions and Dependencies</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li> - The HSSF Serializer and Generator - will support the Gnumeric 1.0 XML tag language. - </li> - -<li> - The HSSF Generator and HSSF - Serializer will be mutually validating. It should be possible to - have an XLS file created by the Serializer run through the Generator - and the output back through the Serializer (via the Cocoon pipeline) - and get the same file or a reasonable facimille (no one cares if it - differs by the order of the binary records in some minor but - non-visually recognizable manner). - </li> - -<li> - The HSSF Generator will run on any - Java 2 supporting platform with Apache Cocoon 2 installed along with - the HSSF and POIFS APIs. - </li> - -<li> - The HSSF Serializer will run on - any Java 2 supporting platform with Apache Cocoon 2 installed along - with the HSSF and POIFS APIs. - </li> - -<li> - The HDF API requires a Java 2 - implementation and the POIFS API. - </li> - -<li> - The HSSF API requires a Java 2 - implementation and the POIFS API. - </li> - -<li> - The POIFS API requires a Java 2 - implementation. - </li> - - -</ul> - -</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>4. Project Features</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Enhancements to the POIFS API will - include: - </p> - -<ul> - -<li> - An event driven API for reading - POIFS Filesystems. - </li> - -<li> - A low-level API for - creating/manipulating POI filesystems. - </li> - -<li> - Code improvements supporting - greater separation between read and write structures. - </li> - -</ul> - -<p align="justify"> - Enhancements to the HSSF API will - include: - </p> - -<ul> - -<li> - An event driven API for reading - XLS files. - </li> - -<li> - Performance improvements. - </li> - -<li> - Formula support (read/write) - </li> - -<li> - Support for user-defined data - formats - </li> - -<li> - Better documentation of the file - format and structure. - </li> - -<li> - An API for creation of charts. - </li> - -</ul> - -<p align="justify"> - The HSSF Generator will include: - </p> - -<ul> - -<li> - A set of classes supporting the - Cocoon 2 Generator interfaces providing a method for reading XLS - files and outputting SAX events. - </li> - -<li> - The same tag format used by the - HSSFSerializer in any given release. - </li> - -</ul> - -<p align="justify"> - The HDF API will include: - </p> - -<ul> - -<li> - An event driven API for reading - DOC files. - </li> - -<li> - A set of high and low level APIs - for reading and writing DOC files. - </li> - -<li> - Documentation of the DOC file - format or enhancements to existing documentation. - </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>5. Other Product Requirements</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>5.1. Applicable Standards</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - All Java code will be 100% pure 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>5.2. System Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The minimum system requirements for the POIFS API are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -</ul> - -<p align="justify"> - The minimum system requirements for the the HSSF API are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -<li>POIFS API</li> - -</ul> - -<p align="justify"> - The minimum system requirements for the the HDF API are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -<li>POIFS API</li> - -</ul> - - -<p align="justify"> - The minimum system requirements for the HSSF Serializer are: - </p> - -<ul> - -<li>64 Mbytes memory</li> - -<li>Java 2 environment</li> - -<li>Pentium or better processor (or equivalent on other platforms)</li> - -<li>Cocoon 2</li> - -<li>HSSF API</li> - -<li>POI API</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>5.3. Performance Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - All components must perform well enough - to be practical for use in a webserver environment (especially - the "killer trio": Cocoon2/Tomcat/Apache combo) - </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>5.4. Environmental Requirements</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The software will run primarily in - developer environments. We should make some allowances for - not-highly-technical users to write XML documents for the HSSF - Serializer. All other components will assume intermediate Java 2 - knowledge. No XML knowledge will be required except for using the - HSSF Serializer. As much documentation as is practical shall be - required for all components as XML is relatively new, and the - concepts introduced for writing spreadsheets and to POI filesystems - will be brand new to Java and many Java developers. - </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>6. Documentation Requirements</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>6.1 POI Filesystem</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The filesystem as read and written by - POI shall be fully documented and explained so that the average Java - developer can understand it. - </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>6.2. POI API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The POI API will be fully documented - through Javadoc. A walkthrough of using the high level POI API shall - be provided. No documentation outside of the Javadoc shall be - provided for the low-level POI APIs. - </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>6.3. HSSF File Format</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF File Format as implemented by - the HSSF API will be fully documented. No documentation will be - provided for features that are not supported by HSSF API that are - supported by the Excel 97 File Format. Care will be taken not to - infringe on any "legal stuff". Additionally, we are - collaborating with the fine folks at OpenOffice.org on - *free* documentation of the format. - </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>6.4. HSSF API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF API will be documented by - javadoc. A walkthrough of using the high level HSSF API shall be - provided. No documentation outside of the Javadoc shall be provided - for the low level HSSF APIs. - </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>6.5 HDF API</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HDF API will be documented by - javadoc. A walkthrough of using the high level HDF API shall be - provided. No documentation outside of the Javadoc shall be provided - for the low level HDF APIs. - </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>6.6 HSSF Serializer</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF Serializer will be documented - by javadoc. - </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>6.7 HSSF Generator</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The HSSF Generator will be documented - by javadoc. - </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>6.8 HSSF Serializer Tag language</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The XML tag language along with - function and usage shall be fully documented. Examples will be - provided as well. - </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>7. Terminology</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>7.1 Filesystem</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - filesystem shall refer only to the POI formatted archive. - </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>7.2 File</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - file shall refer to the embedded data stream within a - POI filesystem. This will be the actual embedded document. - </p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/plan/images/built-with-cocoon.gif b/build/jakarta-poi/docs/plan/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/plan/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/plan/images/cocoon2-small.jpg b/build/jakarta-poi/docs/plan/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/plan/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/plan/images/header.gif b/build/jakarta-poi/docs/plan/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/plan/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/plan/images/jakarta-logo.gif b/build/jakarta-poi/docs/plan/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/plan/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/plan/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/plan/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/plan/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/fileformat.html b/build/jakarta-poi/docs/poifs/fileformat.html deleted file mode 100644 index ad380633f4..0000000000 --- a/build/jakarta-poi/docs/poifs/fileformat.html +++ /dev/null @@ -1,1155 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="fileformat.html">File System Documentation</a> -<br> -<a class="s1" href="usecases.html">Use Cases</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>POIFS File System Internals</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>Introduction</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">POIFS file systems are essentially normal files stored on a - Java-compatible platform's native file system. They are - typically identified by names ending in a four character - extension noting what type of data they contain. For - example, a file ending in ".xls" would likely - contain spreadsheet data, and a file ending in - ".doc" would probably contain a word processing - document. POIFS file systems are called "file - system", because they contain multiple embedded files - in a manner similar to traditional file systems. Along - functional lines, it would be more accurate to call these - POIFS archives. For the remainder of this document it is - referred to as a file system in order to avoid confusion - with the "files" it contains.</p> - -<p align="justify">POIFS file systems are compatible with those document - formats used by a well-known software company's popular - office productivity suite and programs outputting - compatible data. Because the POIFS file system does not - provide compression, encryption or any other worthwhile - feature, its not a good choice unless you require - interoperability with these programs.</p> - -<p align="justify">The POIFS file system does not encode the documents - themselves. For example, if you had a word processor file - with the extension ".doc", you would actually - have a POIFS file system with a document file archived - inside of that file system.</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>Document Conventions</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This document utilizes the numeric types as described by - the Java Language Specification, which can be found at - <a href="http://java.sun.com">http://java.sun.com</a>. In - short:</p> - -<ul> - -<li>A <b>byte</b> is an 8 bit signed integer ranging from - -128 to 127.</li> - -<li>A <b>short</b> is a 16 bit signed integer ranging from - -32768 to 32767</li> - -<li>An <b>int</b> is a 32 bit signed integer ranging from - -2147483648 to 2147483647</li> - -<li>A <b>long</b> is a 64 bit signed integer ranging from - -9.22E18 to 9.22E18.</li> - -</ul> - -<p align="justify">The Java Language Specification spells out a number of - other types that are not referred to by this document.</p> - -<p align="justify">Where this document makes references to "endian - conversion" it is referring to the byte order of - stored numbers. Numbers in "little-endian order" - are stored with the <b>least</b> significant byte first. In - order to properly read a short, for example, you'd read two - bytes and then shift the second byte 8 bits to the left - before performing an <code>or</code> operation to it - against the first byte. The following code illustrates this - method:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -public int getShort (byte[] rec) -{ - return ((rec[1] << 8) | (rec[0] & 0x00ff)); -}</pre> -</td> -</tr> -</table> -</div> - -</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>File System Walkthrough</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This is a walkthrough of a POIFS file system and how it is - put together. It is not intended to give a concise - description but to give a "big picture" of the - general structure and how it's interpreted.</p> - -<p align="justify">A POIFS file system begins with a header. This header - identifies locations in the file by function and provides a - sanity check identifying a file as a POIFS file system.</p> - -<p align="justify">The first 64 bits of the header compose a <b>magic number - identifier.</b> This identifier tells the client software - that this is indeed a POIFS file system and that it should - be treated as such. This is a "sanity check" to - make sure this is a POIFS file system and not some other - format. The header also contains an <b>array of block - numbers</b>. These block numbers refer to blocks in the - file. When these blocks are read together they form the - <b>Block Allocation Table</b>. The header also contains a - pointer to the first element in the <b>property table</b>, - also known as the <b>root element</b>, and a pointer to the - <b>small Block Allocation Table (SBAT)</b>.</p> - -<p align="justify">The <b>block allocation table</b> or <b>BAT</b>, along with - the <b>property table</b>, specify which blocks in the file - system belong to which files. After the header block, the - file system is divided into identically sized blocks of - data, numbered from 0 to however many blocks there are in - the file system. For each file in the file system, its - entry in the property table includes the index of the first - block in the array of blocks. Each block's index into the - array of blocks is also its index into the BAT, and the - integer value stored at that index in the BAT gives the - index of the next block in the array (and thus the index of - the next BAT value). A special value is stored in the BAT - to indicate "end of file".</p> - -<p align="justify">The <b>property table</b> is essentially the directory - storage for the file system. It consists of the name of the - file or directory, its <b>start block</b> in both the file - system and <b>BAT</b>, and its actual size. The first - property in the property table is the <b>root - element</b>. It has two purposes: to be a directory entry - (the root of the directory tree, to be specific), and to - hold the start block for the <b>small block data</b>.</p> - -<p align="justify">Small block data is a special file that contains the data - for small files (less than 4K bytes). It subdivides its - blocks into smaller blocks and there is a special small - block allocation table that, like the main BAT for larger - files, is used to map a small file to its small blocks.</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>Header Block</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The POIFS file system begins with a <b>header - block</b>. The first 64 bits of the header form a long - <b>file type id</b> or <b>magic number identifier</b> of - <code>0xE11AB1A1E011CFD0L</code>. This is basically a - sanity check. If this isn't the first thing in the header - (and consequently the file system) then this is not a - POIFS file system and should be read with some other - library.</p> - -<p align="justify">It's important to know the most important parts of the - header. These are discussed in the rest of this - section.</p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>BATs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">At offset <b>0x2C</b> is an int specifying the number - of elements in the <b>BAT array</b>. The array at - <b>0x4C</b> an array of ints. This array contains the - indices of every block in the Block Allocation - Table.</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>XBATs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Very large POIFS archives may have more blocks than can - be addressed by the BAT blocks enumerated in the header - block. How large? Well, the BAT array in the header can - contain up to 109 BAT block indices; each BAT block - references up to 128 blocks, and each block is 512 - bytes, so we're talking about 109 * 128 * 512 = - 6.8MB. That's a pretty respectable document! But, you - could have much more data than that, and in today's - world of cheap gigabyte drives, why not? So, the BAT - may be extended in that event. The integer value at - offset <b>0x44</b> of the header is the index of the - first <b>extended BAT (XBAT) block</b>. At offset - <b>0x48</b> of the header, there is an int value that - specifies how many XBAT blocks there are. The XBAT - blocks begin at the specified index into the array of - blocks making up the POIFS file system, and continue in - sequence for the specified count of XBAT blocks.</p> - -<p align="justify">Each XBAT block contains the indices of up to 128 BAT - blocks, so the document size can be expanded by another - 8MB for each XBAT block. The BAT blocks indexed by an - XBAT block are appended to the end of the list of BAT - blocks enumerated in the header block. Thus the BAT - blocks enumerated in the header block are BAT blocks 0 - through 108, the BAT blocks enumerated in the first - XBAT block are BAT blocks 109 through 236, the BAT - blocks enumerated in the second XBAT block are BAT - blocks 237 through 364, and so on.</p> - -<p align="justify">Through the use of XBAT blocks, the limit on the - overall document size is that imposed by the 4-byte - block indices; if the indices are unsigned ints, the - maximum file size is 2 terabytes, 1 terabyte if the - indices are treated as signed ints. Either way, I have - yet to see a disk drive large enough to accommodate - such a file on the shelves at the local office supply - stores.</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>SBATs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">If a file contained in a POIFS archive is smaller than - 4096 bytes, it is stored in small blocks. Small blocks - are 64 bytes in length and are contained within big - blocks, up to 8 to a big block. As the main BAT is used - to navigate the array of big blocks, so the <b>small - block allocation table</b> is used to navigate the - array of small blocks. The SBAT's start block index is - found at offset <b>0x3C</b> of the header block, and - remaining blocks constituting the SBAT are found by - walking the main BAT as if it were an ordinary file in - the POIFS file system (this process is described - below).</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Property Table Start Index</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">An integer at address <b>0x30</b> specifies the start - index of the property table. This integer is specified - as a <b>"block index"</b>. The Property Table - is stored, as is almost everything in a POIFS file - system, in big blocks and walked via the BAT. The - Property Table is described below.</p> - -</td> -</tr> -</table> -</div> -<br> - -</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>Property Table</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The property table is essentially nothing more than the - directory system. Properties are 128 byte records - contained within the 512 byte blocks. The first property - is always the Root Entry. The following applies to - individual properties within a property table:</p> - -<ul> - -<li>At offset <b>0x00</b> in the property is the - "<b>name</b>". This is stored as an - uncompressed 16 bit unicode string. In short every - other byte corresponds to an "ASCII" - character. The size of this string is stored at offset - <b>0x40</b> (<b>string size</b>) as a short.</li> - -<li>At offset <b>0x42</b> is the <b>property type</b> - (byte). The type is 1 for directory, 2 for file or 5 - for the Root Entry.</li> - -<li>At offset <b>0x43</b> is the <b>node color</b> - (byte). The color is either 1, (black), or 0, - (red). Properties are apparently meant to be arranged - in a red-black binary tree, subject to the following - rules: - <ol> - -<li>The root of the tree is always black</li> - -<li>Two consecutive nodes cannot both be red</li> - -<li>A property is less than another property if its - name length is less than the other property's name - length</li> - -<li>If two properties have the same name length, the - sort order is determined by the sort order of the - properties' names.</li> - -</ol> -</li> - -<li>At offset <b>0x44</b> is the index (int) of the - <b>previous property</b>.</li> - -<li>At offset <b>0x48</b> is the index (int) of the - <b>next property</b>.</li> - -<li>At offset <b>0x4C</b> is the index (int) of the - <b>first directory entry</b>. This is used by - directory entries.</li> - -<li>At offset <b>0x74</b> is an integer giving the - <b>start block</b> for the file described by this - property. This index corresponds to an index in the - array of indices that is the Block Allocation Table - (or the Small Block Allocation Table) as well as the - index of the first block in the file. This is used by - files and the root entry.</li> - -<li>At offset <b>0x78</b> is an integer giving the total - <b>actual size</b> of the file pointed at by this - property. If the file size is less than 4096, the file - is stored in small blocks and the SBAT is used to walk - the small blocks making up the file. If the file size - is 4096 or larger, the file is stored in big blocks - and the main BAT is used to walk the big blocks making - up the file. The exception to this rule is the <b>Root - Entry</b>, which, regardless of its size, is - <b>always</b> stored in big blocks and the main BAT is - used to walk the big blocks making up this special - file.</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>Root Entry</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The <b>Root Entry</b> in the <b>Property Table</b> - contains the information necessary to read and write - small files, which are files less than 4096 bytes - long. The start block field of the Root Entry is the - start index of the <b>Small Block Array</b>, which is - read like any other file in the POIFS file system. Since - the SBAT cannot be used without the Small Block Array, - the Root Entry MUST be read or written using the <b>Block - Allocation Table</b>. The blocks making up the Small - Block Array are divided into 64-byte small blocks, up to - the size indicated in the Root Entry (which should always - be a multiple of 64).</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>Walking the Nodes of the Property Table</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The individual properties form a directory tree, with the - <b>Root Entry</b> as the directory tree's root, as shown - in the accompanying drawing. Note the numbers in - parentheses in each node; they represent the node's index - in the array of properties. The <b>NEXT_PROP</b>, - <b>PREVIOUS_PROP</b>, and <b>CHILD_PROP</b> fields hold - these indices, and are used to navigate the tree.</p> - -<img src="images/PropertySet.jpg"> - <p align="justify">Each directory entry (i.e., a property whose type is - <b>directory</b> or <b>root entry</b>) uses its - <b>CHILD_PROP</b> field to point to one of its - subordinate (child) properties. It doesn't seem to matter - which of its children it points to. Thus in the previous - drawing, the Root Entry's CHILD_PROP field may contain 1, - 4, or the index of one of its other children. Similarly, - the directory node (index 1) may have, in its CHILD_PROP - field, 2, 3, or the index of one of its other - children.</p> - -<p align="justify">The children of a given directory property point to each - other in a similar fashion by using their - <b>NEXT_PROP</b> and <b>PREVIOUS_PROP</b> fields.</p> - -<p align="justify">Unused <b>NEXT_PROP</b>, <b>PREVIOUS_PROP</b>, and - <b>CHILD_PROP</b> fields contain the marker value of - -1. All file properties have a value of -1 for their - CHILD_PROP fields for example.</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>Block Allocation Table</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The <b>BAT blocks</b> are pointed at by the bat array - contained in the header and supplemented, if necessary, - by the <b>XBAT blocks</b>. These blocks form a large - table of integers. These integers are block numbers. The - <b>Block Allocation Table</b> holds chains of integers. - These chains are terminated with -2. The elements in - these chains refer to blocks in the files. The starting - block of a file is NOT specified in the BAT. It is - specified by the <b>property</b> for a given file. The - elements in this BAT are both the block number (within - the file minus the header) <b>and</b> the number of the - next BAT element in the chain. This can be thought of as - a linked list of blocks. The BAT array contains the links - from one block to the next, including the end of chain - marker.</p> - -<p align="justify">Here's an example: Let's assume that the BAT begins as - follows:</p> - -<p align="justify"> -<code>BAT[ 0 ] = 2</code> -</p> - -<p align="justify"> -<code>BAT[ 1 ] = 5</code> -</p> - -<p align="justify"> -<code>BAT[ 2 ] = 3</code> -</p> - -<p align="justify"> -<code>BAT[ 3 ] = 4</code> -</p> - -<p align="justify"> -<code>BAT[ 4 ] = 6</code> -</p> - -<p align="justify"> -<code>BAT[ 5 ] = -2</code> -</p> - -<p align="justify"> -<code>BAT[ 6 ] = 7</code> -</p> - -<p align="justify"> -<code>BAT[ 7 ] = -2</code> -</p> - -<p align="justify"> -<code>...</code> -</p> - -<p align="justify">Now, if we have a file whose Property Table entry says it - begins with index 0, we walk the BAT array and see that - the file consists of blocks 0 (because the start block is - 0), 2 (because BAT[ 0 ] is 2), 3 (BAT[ 2 ] is 3), 4 (BAT[ - 3 ] is 4), 6 (BAT[ 4 ] is 6), and 7 (BAT[ 6 ] is 7). It - ends at block 7 because BAT[ 7 ] is -2, which is the end - of chain marker.</p> - -<p align="justify">Similarly, a file beginning at index 1 consists of - blocks 1 and 5.</p> - -<p align="justify">Other special numbers in a BAT array are:</p> - -<ul> - -<li>-1, which indicates an unused block</li> - -<li>-3, which indicates a "special" block, such - as a block used to make up the Small Block Array, the - Property Table, the main BAT, or the SBAT</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>File System Structures</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The following outlines the basic file system structures.</p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Header (block 1) -- 512 (0x200) bytes</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Field</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Description</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Offset</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Length</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Default value or const</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">FILETYPE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Magic number identifying this as a POIFS file - system.</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0000</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Long</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0xE11AB1A1E011CFD0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK1</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0008</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK2</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x000C</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK3</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0014</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK4</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant (revision?)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0018</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x003B</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK5</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant (version?)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x001A</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0003</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK6</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x001C</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-2</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">LOG_2_BIG_BLOCK_SIZE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Log, base 2, of the big block size</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x001E</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">9 (2 ^ 9 = 512 bytes)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">LOG_2_SMALL_BLOCK_SIZE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Log, base 2, of the small block size</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0020</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">6 (2 ^ 6 = 64 bytes)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK7</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0024</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK8</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0028</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">BAT_COUNT</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Number of elements in the BAT array</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x002C</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">required</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">PROPERTIES_START</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Block index of the first block of the property - table</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0030</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">required</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK9</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0034</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK10</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0038</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x00001000</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">SBAT_START</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Block index of first big block containing the small - block allocation table (SBAT)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x003C</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-2</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">UK11</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Unknown Constant</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0040</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">1</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">XBAT_START</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Block index of the first block in the Extended Block - Allocation Table (XBAT)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0044</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-2</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">XBAT_COUNT</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Number of elements in the Extended Block Allocation - Table (to be added to the BAT)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0048</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">BAT_ARRAY</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Array of block indices constituting the Block - Allocation Table (BAT)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x004C, 0x0050, 0x0054 ... 0x01FC</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer[]</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-1 for unused elements, at least first element must - be filled.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">N/A</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Header block data not otherwise described in this - table</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">N/A</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">N/A</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-1</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Block Allocation Table Block -- 512 (0x200) bytes</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Field</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Description</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Offset</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Length</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Default value or const</B></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">BAT_ELEMENT</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Any given element in the BAT block</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0000, 0x0004, 0x0008, ... 0x01FC</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>-1 = unused</li> - -<li>-2 = end of chain</li> - -<li>-3 = special (e.g., BAT block)</li> - -</ul> - -<p align="justify">All other values point to the next element in the - chain and the next index of a block composing the - file.</p> - -</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Property Block -- 512 (0x200) byte block</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Field</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Description</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Offset</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Length</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Default value or const</B></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Properties[]</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">This block contains the properties.</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0000, 0x0080, 0x0100, 0x0180</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">128 bytes</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">All unused space is set to -1.</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Property -- 128 (0x80) byte block</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Field</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Description</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Offset</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Length</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Default value or const</B></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">NAME</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">A unicode null-terminated uncompressed 16bit string - (lose the high bytes) containing the name of the - property.</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x00, 0x02, 0x04, ... 0x3E</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short[]</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x0000 for unused elements, field required, 32 - (0x40) element max</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">NAME_SIZE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Number of characters in the NAME field</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x40</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Short</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Required</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">PROPERTY_TYPE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Property type (directory, file, or root)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x42</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Byte</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">1 (directory), 2 (file), or 5 (root entry)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">NODE_COLOR</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Node color</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x43</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Byte</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0 (red) or 1 (black)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">PREVIOUS_PROP</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Previous property index</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x44</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-1</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">NEXT_PROP</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Next property index</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x48</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-1</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">CHILD_PROP</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">First child property index</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x4c</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">-1</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">SECONDS_1</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Seconds component of the created timestamp?</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x64</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">DAYS_1</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Days component of the created timestamp?</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x68</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">SECONDS_2</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Seconds component of the modified timestamp?</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x6C</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">DAYS_2</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Days component of the modified timestamp?</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x70</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">START_BLOCK</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Starting block of the file, used as the first block - in the file and the pointer to the next block from - the BAT</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x74</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Required</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">SIZE</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Actual size of the file this property points - to. (used to truncate the blocks to the real - size).</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0x78</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Integer</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">0</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/poifs/how-to.html b/build/jakarta-poi/docs/poifs/how-to.html deleted file mode 100644 index 3db863416f..0000000000 --- a/build/jakarta-poi/docs/poifs/how-to.html +++ /dev/null @@ -1,1018 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="fileformat.html">File System Documentation</a> -<br> -<a class="s1" href="usecases.html">Use Cases</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>How To Use the POIFS APIs</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This document describes how to use the POIFS APIs to read, write, and modify files that employ a POIFS-compatible data structure to organize their content.</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>Revision History</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<ul> - -<li>02.10.2002 - completely rewritten from original documents on <a href="https://sourceforge.net/cvs/?group_id=32701">sourceforge</a> -</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>Target Audience</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This document is intended for Java developers who need to use the POIFS APIs to read, write, or modify files that employ a POIFS-compatible data structure to organize their content. It is not necessary for developers to understand the POIFS data structures, and an explanation of those data structures is beyond the scope of this document. It is expected that the members of the target audience will understand the rudiments of a hierarchical file system, and familiarity with the event pattern employed by Java APIs such as AWT would be helpful.</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>Glossary</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This document attempts to be consistent in its terminology, which is defined here:</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Term</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Definition</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Directory</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">A special file that may contain other directories and documents.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">DirectoryEntry</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Representation of a directory within another directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Document</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">A file containing data, such as word processing data or a spreadsheet workbook.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">DocumentEntry</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Representation of a document within a directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Entry</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Representation of a file in a directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">File</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">A named entity, managed and contained by the file system.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">File System</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The POIFS data structures, plus the contained directories and documents, which are maintained in a hierarchical directory structure.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Root Directory</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The directory at the base of a file system. All file systems have a root directory. The POIFS APIs will not allow the root directory to be removed or renamed, but it can be accessed for the purpose of reading its contents or adding files (directories and documents) to it.</font></td> - -</tr> -</table> - -</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>Reading a File System</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">This section covers reading a file system. There are two ways to read a file system; these techniques are sketched out in the following table, and then explained in greater depth in the sections following the table.</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Technique</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Advantages</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Disadvantages</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Conventional Reading</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>Simpler API similar to reading a conventional file system.</li> - -<li>Can read documents in any order.</li> - -</ul> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>All files are resident in memory, whether your application needs them or not.</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Event-Driven Reading</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>Reduced footprint -- only the documents you care about are processed.</li> - -<li>Improved performance -- no time is wasted reading the documents you're not interested in.</li> - -</ul> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>More complicated API.</li> - -<li>Need to know in advance which documents you want to read.</li> - -<li>No control over the order in which the documents are read.</li> - -<li>No way to go back and get additional documents except to re-read the file system, which may not be possible, e.g., if the file system is being read from an input stream that lacks random access support.</li> - -</ul> - -</font></td> - -</tr> -</table> - -<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>Conventional Reading</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">In this technique for reading, the entire file system is loaded into memory, and the entire directory tree can be walked by an application, reading specific documents at the application's leisure.</p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Preparation</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Before an application can read a file from the file system, the file system needs to be loaded into memory. This is done by using the <code>org.apache.poi.poifs.filesystem.POIFSFileSystem</code> class. Once the file system has been loaded into memory, the application may need the root directory. The following code fragment will accomplish this preparation stage:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -// need an open InputStream; for a file-based system, this would be appropriate: -// InputStream stream = new FileInputStream(fileName); -POIFSFileSystem fs; -try -{ - fs = new POIFSFileSystem(inputStream); -} -catch (IOException e) -{ - // an I/O error occurred, or the InputStream did not provide a compatible - // POIFS data structure -} -DirectoryEntry root = fs.getRoot();</pre> -</td> -</tr> -</table> -</div> - -<p align="justify">Assuming no exception was thrown, the file system can then be read.</p> - -<p align="justify">Note: loading the file system can take noticeable time, particularly for large file systems.</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Reading the Directory Tree</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Once the file system has been loaded into memory and the root directory has been obtained, the root directory can be read. The following code fragment shows how to read the entries in an <code>org.apache.poi.poifs.filesystem.DirectoryEntry</code> instance:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -// dir is an instance of DirectoryEntry ... -for (Iterator iter = dir.getEntries(); iter.hasNext(); ) -{ - Entry entry = (Entry)iter.next(); - System.out.println("found entry: " + entry.getName()); - if (entry instanceof DirectoryEntry) - { - // .. recurse into this directory - } - else if (entry instanceof DocumentEntry) - { - // entry is a document, which you can read - } - else - { - // currently, either an Entry is a DirectoryEntry or a DocumentEntry, - // but in the future, there may be other entry subinterfaces. The - // internal data structure certainly allows for a lot more entry types. - } -}</pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Reading a Specific Document</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">There are a couple of ways to read a document, depending on whether the document resides in the root directory or in another directory. Either way, you will obtain an <code>org.apache.poi.poifs.filesystem.DocumentInputStream</code> instance.</p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="97%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-2"><font face="Arial,sans-serif"><b>DocumentInputStream</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The DocumentInputStream class is a simple implementation of InputStream that makes a few guarantees worth noting:</p> - -<ul> - -<li> -<code>available()</code> always returns the number of bytes in the document from your current position in the document.</li> - -<li> -<code>markSupported()</code> returns <code>true</code>.</li> - -<li> -<code>mark(int limit)</code> ignores the limit parameter; basically the method marks the current position in the document.</li> - -<li> -<code>reset()</code> takes you back to the position when <code>mark()</code> was last called, or to the beginning of the document if <code>mark()</code> has not been called.</li> - -<li> -<code>skip(long n)</code> will take you to your current position + n (but not past the end of the document).</li> - -</ul> - -<p align="justify">The behavior of <code>available</code> means you can read in a document in a single read call like this:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -byte[] content = new byte[ stream.available() ]; -stream.read(content); -stream.close();</pre> -</td> -</tr> -</table> -</div> - -<p align="justify">The combination of <code>mark</code>, <code>reset</code>, and <code>skip</code> provide the basic mechanisms needed for random access of the document contents.</p> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="97%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-2"><font face="Arial,sans-serif"><b>Reading a Document From the Root Directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">If the document resides in the root directory, you can obtain a <code>DocumentInputStream</code> like this:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -// load file system -try -{ - DocumentInputStream stream = filesystem.createDocumentInputStream(documentName); - // process data from stream -} -catch (IOException e) -{ - // no such document, or the Entry represented by documentName is not a - // DocumentEntry -}</pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="97%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-2"><font face="Arial,sans-serif"><b>Reading a Document From an Arbitrary Directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">A more generic technique for reading a document is to obtain an <code>org.apache.poi.poifs.filesystem.DirectoryEntry</code> instance for the directory containing the desired document (recall that you can use <code>getRoot()</code> to obtain the root directory from its file system). From that DirectoryEntry, you can then obtain a <code>DocumentInputStream</code> like this:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -DocumentEntry document = (DocumentEntry)directory.getEntry(documentName); -DocumentInputStream stream = new DocumentInputStream(document); -</pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> - -</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>Event-Driven Reading</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The event-driven API for reading documents is a little more complicated and requires that your application know, in advance, which files it wants to read. The benefit of using this API is that each document is in memory just long enough for your application to read it, and documents that you never read at all are not in memory at all. When you're finished reading the documents you wanted, the file system has no data structures associated with it at all and can be discarded.</p> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Preparation</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The preparation phase involves creating an instance of <code>org.apache.poi.poifs.eventfilesystem.POIFSReader</code> and to then register one or more <code>org.apache.poi.poifs.eventfilesystem.POIFSReaderListener</code> instances with the <code>POIFSReader</code>.</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -POIFSReader reader = new POIFSReader(); -// register for everything -reader.registerListener(myOmnivorousListener); -// register for selective files -reader.registerListener(myPickyListener, "foo"); -reader.registerListener(myPickyListener, "bar"); -// register for selective files -reader.registerListener(myOtherPickyListener, new POIFSDocumentPath(), - "fubar"); -reader.registerListener(myOtherPickyListener, new POIFSDocumentPath( - new String[] { "usr", "bin" ), "fubar");</pre> -</td> -</tr> -</table> -</div> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>POIFSReaderListener</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> -<code>org.apache.poi.poifs.eventfilesystem.POIFSReaderListener</code> is an interface used to register for documents. When a matching document is read by the <code>org.apache.poi.poifs.eventfilesystem.POIFSReader</code>, the <code>POIFSReaderListener</code> instance receives an <code>org.apache.poi.poifs.eventfilesystem.POIFSReaderEvent</code> instance, which contains an open <code>DocumentInputStream</code> and information about the document.</p> - -<p align="justify">A <code>POIFSReaderListener</code> instance can register for individual documents, or it can register for all documents; once it has registered for all documents, subsequent (and previous!) registration requests for individual documents are ignored. There is no way to unregister a <code>POIFSReaderListener</code>.</p> - -<p align="justify">Thus, it is possible to register a single <code>POIFSReaderListener</code> for multiple documents - one, some, or all documents. It is guaranteed that a single <code>POIFSReaderListener</code> will receive exactly one notification per registered document. There is no guarantee as to the order in which it will receive notification of its documents, as future implementations of <code>POIFSReader</code> are free to change the algorithm for walking the file system's directory structure.</p> - -<p align="justify">It is also permitted to register more than one <code>POIFSReaderListener</code> for the same document. There is no guarantee of ordering for notification of <code>POIFSReaderListener</code> instances that have registered for the same document when <code>POIFSReader</code> processes that document.</p> - -<p align="justify">It is guaranteed that all notifications occur in the same thread. A future enhancement may be made to provide multi-threaded notifications, but such an enhancement would very probably be made in a new reader class, a <code>ThreadedPOIFSReader</code> perhaps.</p> - -<p align="justify">The following table describes the three ways to register a <code>POIFSReaderListener</code> for a document or set of documents:</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Method Signature</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>What it does</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registerListener(POIFSReaderListener <b>listener</b>)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registers <b>listener</b> for all documents.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registerListener(POIFSReaderListener <b>listener</b>, String <b>name</b>)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registers <b>listener</b> for a document with the specified <b>name</b> in the root directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registerListener(POIFSReaderListener <b>listener</b>, POIFSDocumentPath <b>path</b>, String <b>name</b>)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">registers <b>listener</b> for a document with the specified <b>name</b> in the directory described by <b>path</b></font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>POIFSDocumentPath</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">The <code>org.apache.poi.poifs.filesystem.POIFSDocumentPath</code> class is used to describe a directory in a POIFS file system. Since there are no reserved characters in the name of a file in a POIFS file system, a more traditional string-based solution for describing a directory, with special characters delimiting the components of the directory name, is not feasible. The constructors for the class are used as follows:</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Constructor example</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Directory described</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">new POIFSDocumentPath()</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The root directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">new POIFSDocumentPath(null)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The root directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">new POIFSDocumentPath(new String[ 0 ])</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The root directory.</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">new POIFSDocumentPath(new String[ ] { "foo", "bar"} )</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">in Unix terminology, "/foo/bar".</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">new POIFSDocumentPath(new POIFSDocumentPath(new String[] { "foo" }), new String[ ] { "fu", "bar"} )</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">in Unix terminology, "/foo/fu/bar".</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -<div align="right"> -<table cellspacing="0" cellpadding="2" border="0" width="98%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" size="-1"><font face="Arial,sans-serif"><b>Processing POIFSReaderEvent Events</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Processing <code>org.apache.poi.poifs.eventfilesystem.POIFSReaderEvent</code> events is relatively easy. After all of the <code>POIFSReaderListener</code> instances have been registered with <code>POIFSReader</code>, the <code>POIFSReader.read(InputStream stream)</code> method is called.</p> - -<p align="justify">Assuming that there are no problems with the data, as the <code>POIFSReader</code> processes the documents in the specified <code>InputStream</code>'s data, it calls registered <code>POIFSReaderListener</code> instances' <code>processPOIFSReaderEvent</code> method with a <code>POIFSReaderEvent</code> instance.</p> - -<p align="justify">The <code>POIFSReaderEvent</code> instance contains information to identify the document (a <code>POIFSDocumentPath</code> object to identify the directory that the document is in, and the document name), and an open <code>DocumentInputStream</code> instance from which to read the document.</p> - -</td> -</tr> -</table> -</div> -<br> - -</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>Writing a File System</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Writing a file system is very much like reading a file system in that there are multiple ways to do so. You can load an existing file system into memory and modify it (removing files, renaming files) and/or add new files to it, and write it, or you can start with a new, empty file system:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -POIFSFileSystem fs = new POIFSFileSystem();</pre> -</td> -</tr> -</table> -</div> - -<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>The Naming of Names</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">There are two restrictions on the names of files in a file system that must be considered when creating files:</p> - -<ol> - -<li>The name of the file must not exceed 31 characters. If it does, the POIFS API will silently truncate the name to fit.</li> - -<li>The name of the file must be unique within its containing directory. This seems pretty obvious, but if it isn't spelled out, there'll be hell to pay, to be sure. Uniqueness, of course, is determined <b>after</b> the name has been truncated, if the original name was too long to begin with.</li> - -</ol> - -</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>Creating a Document</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">A document can be created by acquiring a <code>DirectoryEntry</code> and calling one of the two <code>createDocument</code> methods:</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Method Signature</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Advantages</b></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><b>Disadvantages</b></font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">CreateDocument(String name, InputStream stream)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>Simple API.</li> - -</ul> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>Increased memory footprint (document is in memory until file system is written).</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">CreateDocument(String name, int size, POIFSWriterListener writer)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>Decreased memory footprint (only very small documents are held in memory, and then only for a short time).</li> - -</ul> - -</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>More complex API.</li> - -<li>Determining document size in advance may be difficult.</li> - -<li>Lose control over when document is to be written.</li> - -</ul> - -</font></td> - -</tr> -</table> - -<p align="justify">Unlike reading, you don't have to choose between the in-memory and event-driven writing models; both can co-exist in the same file system.</p> - -<p align="justify">Writing is initiated when the <code>POIFSFileSystem</code> instance's <code>writeFilesystem()</code> method is called with an <code>OutputStream</code> to write to.</p> - -<p align="justify">The event-driven model is quite similar to the event-driven model for reading, in that the file system calls your <code>org.apache.poi.poifs.filesystem.POIFSWriterListener</code> when it's time to write your document, just as the <code>POIFSReader</code> calls your <code>POIFSReaderListener</code> when it's time to read your document. Internally, when <code>writeFilesystem()</code> is called, the final POIFS data structures are created and are written to the specified <code>OutputStream</code>. When the file system needs to write a document out that was created with the event-driven model, it calls the <code>POIFSWriterListener</code> back, calling its <code>processPOIFSWriterEvent()</code> method, passing an <code>org.apache.poi.poifs.filesystem.POIFSWriterEvent</code> instance. This object contains the <code>POIFSDocumentPath</code> and name of the document, its size, and an open <code>org.apache.poi.poifs.filesystem.DocumentOutputStream</code> to which to write. A <code>DocumentOutputStream</code> is a wrapper over the <code>OutputStream</code> that was provided to the <code>POIFSFileSystem</code> to write to, and has the responsibility of making sure that the document your application writes fits within the size you specified for it.</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>Creating a Directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Creating a directory is similar to creating a document, except that there's only one way to do so:</p> - -<div align="center"> -<table cellspacing="2" cellpadding="2" border="1"> -<tr> -<td> -<pre> -DirectoryEntry createdDir = existingDir.createDirectory(name);</pre> -</td> -</tr> -</table> -</div> - -</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>Using POIFSFileSystem Directly To Create a Document Or Directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">As with reading documents, it is possible to create a new document or directory in the root directory by using convenience methods of POIFSFileSystem.</p> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">DirectoryEntry Method Signature</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFSFileSystem Method Signature</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDocument(String name, InputStream stream)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDocument(InputStream stream, String name)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDocument(String name, int size, POIFSWriterListener writer)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDocument(String name, int size, POIFSWriterListener writer)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDirectory(String name)</font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">createDirectory(String name)</font></td> - -</tr> -</table> - -</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>Modifying a File System</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">It is possible to modify an existing POIFS file system, whether it's one your application has loaded into memory, or one which you are creating on the fly.</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>Removing a Document</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Removing a document is simple: you get the <code>Entry</code> corresponding to the document and call its <code>delete()</code> method. This is a boolean method, but should always return <code>true</code>, indicating that the operation succeeded.</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>Removing a Directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Removing a directory is also simple: you get the <code>Entry</code> corresponding to the directory and call its <code>delete()</code> method. This is a boolean method, but, unlike deleting a document, may not always return <code>true</code>, indicating that the operation succeeded. Here are the reasons why the operation may fail:</p> - -<ul> - -<li>The directory still has files in it (to check, call <code>isEmpty()</code> on its DirectoryEntry; is the return value <code>false</code>?)</li> - -<li>The directory is the root directory. You cannot remove the root directory.</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>Renaming a File</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify">Regardless of whether the file is a directory or a document, it can be renamed, with one exception - the root directory has a special name that is expected by the components of a major software vendor's office suite, and the POIFS API will not let that name be changed. Renaming is done by acquiring the file's corresponding <code>Entry</code> instance and calling its <code>renameTo</code> method, passing in the new name.</p> - -<p align="justify">Like <code>delete</code>, <code>renameTo</code> returns <code>true</code> if the operation succeeded, otherwise <code>false</code>. Reasons for failure include these:</p> - -<ul> - -<li>The new name is the same as another file in the same directory. And don't forget - if the new name is longer than 31 characters, it <b>will</b> be silently truncated. In its original length, the new name may have been unique, but truncated to 31 characters, it may not be unique any longer.</li> - -<li>You tried to rename the root directory.</li> - -</ul> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/poifs/images/PropertySet.jpg b/build/jakarta-poi/docs/poifs/images/PropertySet.jpg Binary files differdeleted file mode 100644 index c0d1461020..0000000000 --- a/build/jakarta-poi/docs/poifs/images/PropertySet.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/images/built-with-cocoon.gif b/build/jakarta-poi/docs/poifs/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/poifs/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/images/cocoon2-small.jpg b/build/jakarta-poi/docs/poifs/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/poifs/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/images/header.gif b/build/jakarta-poi/docs/poifs/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/poifs/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/images/jakarta-logo.gif b/build/jakarta-poi/docs/poifs/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/poifs/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/poifs/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/poifs/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/poifs/index.html b/build/jakarta-poi/docs/poifs/index.html deleted file mode 100644 index 9abadb0748..0000000000 --- a/build/jakarta-poi/docs/poifs/index.html +++ /dev/null @@ -1,152 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>PoiFS</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="fileformat.html">File System Documentation</a> -<br> -<a class="s1" href="usecases.html">Use Cases</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>PoiFS</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">PoiFS</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/poifs/usecases.html b/build/jakarta-poi/docs/poifs/usecases.html deleted file mode 100644 index 942914ec66..0000000000 --- a/build/jakarta-poi/docs/poifs/usecases.html +++ /dev/null @@ -1,1266 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title></title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<a class="s1" href="how-to.html">How To</a> -<br> -<a class="s1" href="fileformat.html">File System Documentation</a> -<br> -<a class="s1" href="usecases.html">Use Cases</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"><font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>POIFS 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 file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to read content of file - system</li> - -<li>POIFS - understands POIFS file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS client requests POIFS to read a POIFS file - system, providing an <code>InputStream</code> - containing POIFS file system in question.</li> - -<li>POIFS reads from the <code>InputStream</code> in - 512 byte blocks</li> - -<li>POIFS verifies that the first block begins with - the well known signature - (<code>0xE11AB1A1E011CFD0</code>)</li> - -<li>POIFS reads the Block Allocation Table from the - first block and, if necessary, from the XBAT - blocks.</li> - -<li>POIFS obtains the start block of the Property - Table and reads the Property Table (use case 9, - read file)</li> - -<li>POIFS reads the individual entries in the Property - Table</li> - -<li>POIFS obtains the start block of the Small Block - Allocation Table and reads the Small Block - Allocation Table (use case 9, read file)</li> - -<li>POIFS obtains the start block of the Small Block - store from the first entry in the Property Table - and reads the Small Block Array (use case 9, read - file)</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>2a. If the last block read is not a 512 byte - block, the <code>InputStream</code> is not that of - a POIFS file system, and POIFS throws an - appropriate exception.</li> - -<li>3a. If the signature is incorrect, the - <code>InputStream</code> is not that of a POIFS - file system, and POIFS throws an appropriate - exception.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</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 file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to write file system out.</li> - -<li>POIFS - knows how to write file system out.</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>File system has been read (use case 1, read - existing file system) and subsequently modified - (use case 4, replace file in file system; use case - 5, delete file from file system; or use case 6, - write new file to file system; in any - combination)</li> - -</ul> - -<p align="justify">or</p> - -<ul> - -<li>File system has been created (use case 3, create - new file system)</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS client provides an <code>OutputStream</code> - to write the file system to.</li> - -<li>POIFS gets the sizes of the Property Table and - each file in the file system.</li> - -<li>If any files in the file system requires storage - in a Small Block Array, POIFS creates a Small - Block Array of sufficient size to hold all of the - small files.</li> - -<li>POIFS calculates the number of big blocks needed - to hold all of the large files, the Property - Table, and, if necessary, the Small Block Array - and the Small Block Allocation Table.</li> - -<li>POIFS creates a set of big blocks sufficient to - store the Block Allocation Table</li> - -<li>POIFS creates and writes the header block</li> - -<li>POIFS writes out the XBAT blocks, if needed.</li> - -<li>POIFS writes out the Small Block Array, if - needed</li> - -<li>POIFS writes out the Small Block Allocation Table, - if needed</li> - -<li>POIFS writes out the Property Table</li> - -<li>POIFS writes out the large files, if needed</li> - -<li>POIFS closes the <code>OutputStream</code>.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>6a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>7a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>8a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>9a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>10a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>11a. Exceptions writing to the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -<li>12a. Exceptions closing the - <code>OutputStream</code> will be propagated back - to the POIFS client.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</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 new file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to create a new file - system</li> - -<li>POIFS - knows how to create a new file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS creates an empty Property Table.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -</table> - -</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: Replace file in file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to replace an existing file in - the file system</li> - -<li>POIFS - knows how to manage the file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Either</p> - -<ul> - -<li>The file system has been read (use case 1, read - existing file system) and a file has been - extracted from the file system (use case 7, read - existing file from file system)</li> - -</ul> - -<p align="justify">or</p> - -<ul> - -<li>The file system has been created (use case 3, - create new file system) and a file has been - written to the file system (use case 6, write new - file to file system)</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS discards storage of the existing file.</li> - -<li>POIFS updates the existing file's entry in the - Property Table</li> - -<li>POIFS stores the new file's data</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>1a. POIFS throws an exception if the file does not - exist.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</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: Delete file from file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to remove a file from a file - system</li> - -<li>POIFS - knows how to manage the file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<p align="justify">Either</p> - -<ul> - -<li>The file system has been read (use case 1, read - existing file system) and a file has been - extracted from the file system (use case 7, read - existing file from file system)</li> - -</ul> - -<p align="justify">or</p> - -<ul> - -<li>The file system has been created (use case 3, - create new file system) and a file has been - written to the file system (use case 6, write new - file to file system)</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS discards the specified file's storage.</li> - -<li>POIFS discards the file's Property Table - entry.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>1a. POIFS throws an exception if the file does not - exist.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</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 6: Write new file to file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to add a new file to the file - system</li> - -<li>POIFS - knows how to manage the file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The specified file does not yet exist in the file - system</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>The POIFS client provides a file name</li> - -<li>POIFS creates a new Property Table entry for the - new file</li> - -<li>POIFS provides the POIFS client with an - <code>OutputStream</code> to write to.</li> - -<li>The POIFS client writes data to the provided - <code>OutputStream</code>.</li> - -<li>The POIFS client closes the provided - <code>OutputStream</code> -</li> - -<li>POIFS updates the Property Table entry with the - new file's size</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>1a. POIFS throws an exception if a file with the - specified name already exists in the file - system.</li> - -<li>1b. POIFS throws an exception if the file name is - too long. The limit on file name length is 31 - characters.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</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 7: Read existing file from file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to read a file from the file - system</li> - -<li>POIFS - knows how to manage the file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>The file system has been read (use case 1, read - existing file system) or has been created and - written to (use case 3, create new file system; - use case 6, write new file to file system).</li> - -<li>The specified file exists in the file system.</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>The POIFS client provides the name of a file to be - read</li> - -<li>POIFS provides an <code>InputStream</code> to read - from.</li> - -<li>The POIFS client reads from the - <code>InputStream</code>.</li> - -<li>The POIFS client closes the - <code>InputStream</code>.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">1a. POIFS throws an exception if no file with the - specified name exists.</font></td> - -</tr> -</table> - -</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 8: Read file system directory</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to know what files exist in - the file system</li> - -<li>POIFS - knows how to manage the file system</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">The file system has been read (use case 1, read - existing file system) or created (use case 3, create - new file system)</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>The POIFS client requests the file system - directory.</li> - -<li>POIFS returns an <code>Iterator</code>. The - <code>Iterator</code> will not include the root - entry in the Property Table, and may be an - <code>Iterator</code> over an empty - <code>Collection</code>.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -</table> - -</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 9: Read file</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS - POIFS needs to read a file, or something - resembling a file (i.e., the Property Table, the - Small Block Array, or the Small Block Allocation - Table)</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS begins with a start block, a file size, and - a flag indicating whether to use the Big Block - Allocation Table or the Small Block Allocation - Table</li> - -<li>POIFS returns an <code>InputStream</code>.</li> - -<li>Reads from the <code>InputStream</code> are - performed by walking the specified Block - Allocation Table and reading the blocks - indicated.</li> - -<li>POIFS closes the <code>InputStream</code> when - finished reading the file, or its client wants to - close the <code>InputStream</code>.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">3a. An exception will be thrown if the specified Block - Allocation Table is corrupt, as evidenced by an index - pointing to a non-existent block, or by a chain - extending past the known size of the file.</font></td> - -</tr> -</table> - -</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 10: Rename existing file in the file system</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<table width="100%" cellspacing="2" cellpadding="2" border="0"> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Primary Actor:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS client</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Scope:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">POIFS</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Level:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">Summary</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Stakeholders and Interests:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>POIFS client- wants to rename an existing file in - the file system.</li> - -<li>POIFS - knows how to manage the file system.</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Precondition:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>The file system is has been read (use case 1, read - existing file system) or has been created and - written to (use case 3, create new file system; - use case 6, write new file to file system.</li> - -<li>The specified file exists in the file system.</li> - -<li>The new name for the file does not duplicate - another file in the file system.</li> - -</ul> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Minimal Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000">None</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Main Success Guarantee:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ol> - -<li>POIFS updates the Property Table entry for the - specified file with its new name.</li> - -</ol> - -</font></td> - -</tr> -<tr> - -<td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"><B>Extensions:</B></font></td> - <td valign="top" bgcolor="#a0ddf0" align="left"><font size="-1" color="#000000"> - -<ul> - -<li>1a. If the old file name is not in the file - system, POIFS throws an exception.</li> - -<li>1b. If the new file name already exists in the - file system, POIFS throws an exception.</li> - -<li>1c. If the new file name is too long (the limit is - 31 characters), POIFS throws an exception.</li> - -</ul> - -</font></td> - -</tr> -</table> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/resolutions/images/built-with-cocoon.gif b/build/jakarta-poi/docs/resolutions/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/resolutions/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/resolutions/images/cocoon2-small.jpg b/build/jakarta-poi/docs/resolutions/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/resolutions/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/resolutions/images/header.gif b/build/jakarta-poi/docs/resolutions/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/resolutions/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/resolutions/images/jakarta-logo.gif b/build/jakarta-poi/docs/resolutions/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/resolutions/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/resolutions/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/resolutions/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/resolutions/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/resolutions/index.html b/build/jakarta-poi/docs/resolutions/index.html deleted file mode 100644 index 30fc185523..0000000000 --- a/build/jakarta-poi/docs/resolutions/index.html +++ /dev/null @@ -1,148 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Resolutons</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">About</a> -<br> -<br> -<span class="s1">Resolutions</span> -<br> -<a class="s1" href="res001.html">Coding Standards</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Resolutons</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Resolutons</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>About Resolutions</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Every project on Jakarta has resolutions that they vote on. - Decisions are made, etc. But what happens once those decisions - are made? They are archived in the mail list archive never to - be read again (once its not in the top 10 or so posts). So they - get discussed again and again. - </p> - -<p align="justify"> - Rather than have that big waste of time, we have this section to - record important POI decisions. Once a decision is passed it - need only be linked to this page (either by creating a page for - it or by simply linking it to the archive messages). Wherever - possible a brief about how many votes for and against an maybe - some background should be posted. - </p> - -<p align="justify"> - This section is intended mainly to reduce big waste of time - discussions from taking away from whats important...developing - POI! :-D - </p> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/resolutions/res001.html b/build/jakarta-poi/docs/resolutions/res001.html deleted file mode 100644 index 9e0c8260bf..0000000000 --- a/build/jakarta-poi/docs/resolutions/res001.html +++ /dev/null @@ -1,252 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>POI Resoluton</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">About</a> -<br> -<br> -<span class="s1">Resolutions</span> -<br> -<a class="s1" href="res001.html">Coding Standards</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>POI Resoluton</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">POI Resoluton</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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>Resolution 001 - Minimal Coding Standards</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>Majority Position</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - As the POI project has grown the "styles" used have become more - varied, some see this as a bad thing, but in reality it - can be a good thing. Each can learn from the different - styles by working with different code. That being said - there are some universal "good quality" guidelines that - must be adopted on a project of any proportions. - </p> - -<p align="justify"> - Marc Johnson Authored the following resolution: - </p> - -<p align="justify"> - On Tue, 2002-01-08 at 22:23, Marc Johnson wrote: - Standards are wonderful; everyone should have a set. - Here's what I propose for coding standards for POI WRT comments (should I - feel the need, I'll post more of these little gems): - </p> - -<ol> - -<li> - All classes and interfaces MUST have, right at the beginning, the POI - License (see poi/doc/LICENSE). - </li> - -<li> - All classes and interfaces MUST include class javadoc. Conventionally, - this goes after the package and imports, and before the start of the class - or interface. The class javadoc MUST have at least one @author tag - </li> - -<li> - All methods that are accessible outside the class MUST have javadoc - comments. In other words, if it isn't private, it MUST have javadoc - comments. Simple getters can consist of a simple @return tag; simple setters - can consist of a simple @param tag. Anything else requires some verbiage - plus all the standard javadoc tags as appropriate. You MUST include @throws - or @exception for any non-runtime exceptions, and you SHOULD document any - runtime exceptions you expect to throw. @throws/@exception tags SHOULD - include an explanation of why that exception would be thrown. If your method - might return null, you MUST say so. An accompanying explanation of the - circumstances for doing so would be nice. - </li> - -</ol> - -</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>Amendments (informal by extension and not by vote)</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - As opposed to the formerly used POI License which was - based on the Apache Public License, now that POI is part of - Jakarta, use the APL 1.1 for the header. Currently, the - Apache Software Foundation requires us to use the full - long version. - </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>Dissent</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - The motion was passed unanimously with no negative or - positive votes. - </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>Comments</b></font></font></td> -</tr> -<tr> -<td> -<br> - -<p align="justify"> - Andy didn't feel like going through his mail and sucking - out the comments.. If there is anything you feel should - be added here do it yourself ;-). - </p> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/todo.html b/build/jakarta-poi/docs/todo.html deleted file mode 100644 index 97fd01ee4e..0000000000 --- a/build/jakarta-poi/docs/todo.html +++ /dev/null @@ -1,226 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Things To Do for Poi</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Things To Do for Poi</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Things To Do for Poi</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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> - Finish HDF - </li> -<li> -<em>[code]</em> - Finish Charts - </li> -<li> -<em>[code]</em> - Add Formulas. - </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> - Expose functionality in low level records in higher level API - </li> -<li> -<em>[code]</em> - Implement more record types (for other things ... not sure - what this will mean yet). - </li> -<li> -<em>[code]</em> - Implement more record types (for other things ... not sure - what this will mean yet). - </li> -<li> -<em>[code]</em> - Add more dummy checks (for when API user's do things they - "can't" do) - </li> -<li> -<em>[code]</em> - Add support for embedded graphics and stuff like that. - </li> -<li> -<em>[code]</em> - Create new adapter object for handling MulBlank, MulRk, Rk - records. - </li> -</sl> -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/utils/images/built-with-cocoon.gif b/build/jakarta-poi/docs/utils/images/built-with-cocoon.gif Binary files differdeleted file mode 100644 index 0b38f7857b..0000000000 --- a/build/jakarta-poi/docs/utils/images/built-with-cocoon.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/utils/images/cocoon2-small.jpg b/build/jakarta-poi/docs/utils/images/cocoon2-small.jpg Binary files differdeleted file mode 100644 index e8f6dd8c8c..0000000000 --- a/build/jakarta-poi/docs/utils/images/cocoon2-small.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/utils/images/header.gif b/build/jakarta-poi/docs/utils/images/header.gif Binary files differdeleted file mode 100644 index b9c2ee1391..0000000000 --- a/build/jakarta-poi/docs/utils/images/header.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/utils/images/jakarta-logo.gif b/build/jakarta-poi/docs/utils/images/jakarta-logo.gif Binary files differdeleted file mode 100644 index 82baef3abe..0000000000 --- a/build/jakarta-poi/docs/utils/images/jakarta-logo.gif +++ /dev/null diff --git a/build/jakarta-poi/docs/utils/images/krysalis-compatible.jpg b/build/jakarta-poi/docs/utils/images/krysalis-compatible.jpg Binary files differdeleted file mode 100644 index 077f8a1179..0000000000 --- a/build/jakarta-poi/docs/utils/images/krysalis-compatible.jpg +++ /dev/null diff --git a/build/jakarta-poi/docs/utils/index.html b/build/jakarta-poi/docs/utils/index.html deleted file mode 100644 index d3c3aea563..0000000000 --- a/build/jakarta-poi/docs/utils/index.html +++ /dev/null @@ -1,134 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Poi Utils</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">Navigation</span> -<br> -<a class="s1" href="../index.html">Main</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Poi Utils</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Poi Utils</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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 width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> diff --git a/build/jakarta-poi/docs/who.html b/build/jakarta-poi/docs/who.html deleted file mode 100644 index 44885e2c87..0000000000 --- a/build/jakarta-poi/docs/who.html +++ /dev/null @@ -1,267 +0,0 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<meta content="text/html; charset=ISO-8859-1"> -<title>Who we are</title> -<style type="text/css"> - body { background-color: white; font-size: normal; color: black ; } - a { color: #525d76; } - a.black { color: #000000;} - table {border-width: 0; width: 100%} - table.centered {text-align: center} - table.title {text-align: center; width: 80%} - img{border-width: 0;} - span.s1 {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.s1_white { font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #ffffff; } - span.title {font-family: Helvetica, Arial, sans-serif; font-weight: bold; color: #000000; } - span.c1 {color: #000000; font-family: Helvetica, Arial, sans-serif} - tr.left {text-align: left} - hr { width: 100%; size: 2} -</style> -</head> -<body> -<table width="100%" cellspacing="0" cellpadding="0" border="0"> -<tr> -<td valign="top" align="left"><a href="http://jakarta.apache.org/index.html"><img hspace="0" vspace="0" border="0" src="images/jakarta-logo.gif"></a></td><td width="100%" valign="top" align="left" bgcolor="#ffffff"><img hspace="0" vspace="0" border="0" align="right" src="images/header.gif"></td> -</tr> -<tr> -<td colspan="2" bgcolor="#525d76"><span class="c1"><a class="black" href="http://www.apache.org/">www.apache.org ></a><a class="black" href="http://jakarta.apache.org/">jakarta.apache.org ></a><a href="http://jakarta.apache.org/poi/" class="black">jakarta.apache.org/poi</a></span></td> -</tr> -<tr> -<td height="8"></td> -</tr> -</table> -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr> -<td width="1%"> -<br> -</td><td nowrap="1" valign="top" width="14%"> -<br> -<span class="s1">About</span> -<br> -<a class="s1" href="index.html">Index</a> -<br> -<a class="s1" href="historyandfuture.html">History</a> -<br> -<a class="s1" href="historyandfuture.html">Future</a> -<br> -<a class="s1" href="http://jakarta.apache.org/builds/jakarta-poi/">Download</a> -<br> -<a class="s1" href="plan/POI10Vision.html">1.0 Vision</a> -<br> -<a class="s1" href="plan/POI20Vision.html">2.0 Vision</a> -<br> -<a class="s1" href="who.html">Who we are</a> -<br> -<a class="s1" href="changes.html">Changes</a> -<br> -<a class="s1" href="faq.html">FAQ</a> -<br> -<br> -<span class="s1">Sub-Projects</span> -<br> -<a class="s1" href="overview.html">Overview</a> -<br> -<a class="s1" href="poifs/index.html">POIFS</a> -<br> -<a class="s1" href="hssf/index.html">HSSF</a> -<br> -<a class="s1" href="hdf/index.html">HDF</a> -<br> -<a class="s1" href="hpsf/index.html">HPSF</a> -<br> -<a class="s1" href="utils/index.html">POI-Utils</a> -<br> -<br> -<span class="s1">References</span> -<br> -<a class="s1" href="inthenews.html">In The News</a> -<br> -<a class="s1" href="livesites.html">Live Sites</a> -<br> -<a class="s1" href="http://sc.openoffice.org/excelfileformat.pdf">XLS spec [PDF]</a> -<br> -<a class="s1" href="http://xml.apache.org/cocoon/">Apache Cocoon</a> -<br> -<a class="s1" href="resolutions/index.html">Resolutions</a> -<br> -<br> -<span class="s1">Get Involved</span> -<br> -<a class="s1" href="contrib.html">Contributing</a> -<br> -<a class="s1" href="http://nagoya.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/cvsindex.html">CVS</a> -<br> -<a class="s1" href="http://jakarta.apache.org/site/mail.html">Mail Lists</a> -<br> -</td><td width="1%"> -<br> -</td><td align="left" valign="top" width="*"> -<title>Who we are</title> -<table width="100%" align="center" class="centered"> -<tbody> -<tr> -<td align="center"> -<table border="0" cellpadding="1" cellspacing="0" class="title"> -<tbody> -<tr> -<td bgcolor="#525d76"> -<table width="100%" border="0" cellpadding="2" cellspacing="0" class="centered"> -<tbody> -<tr> -<td bgcolor="#f3dd61"><span class="title">Who we are</span></td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -</td> -</tr> -</tbody> -</table> -<font size="-2" color="#000000"> -<p> -<a href="mailto:"></a> -</p> -</font> -<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> - -<li>Glen Stampoultzis (glens at apache.org)</li> - -<li> -<a href="http://www.rainer-klute.de/">Rainer Klute</a> (klute at apache dot org)</li> - -<li>Nicola Ken Barozzi (barozzi at nicolaken dot com)</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>Ryan Ackley (sackley at cfl dot rr dot com)</li> - -</ul> - -</td> -</tr> -</table> -</div> -<br> - -</td> -</tr> -</table> -</div> -<br> -</td> -</tr> -</table> -<br> -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tbody> -<tr> -<td> -<hr noshade="" size="1"> -</td> -</tr> -<tr> -<td align="center"><i>Copyright © 2002 Apache Software Foundation</i></td> -</tr> -<tr> -<td align="right" width="100%"> -<br> -</td> -</tr> -<tr> -<td align="right" width="100%"><a href="http://krysalis.org/"><img alt="Krysalis Logo" src="images/krysalis-compatible.jpg"></a><a href="http://xml.apache.org/cocoon/"><img alt="Cocoon Logo" src="images/built-with-cocoon.gif"></a></td> -</tr> -</tbody> -</table> -</body> -</html> |
