<body>
<section><title>How To Use the HPSF APIs</title>
- <p>This HOW-TO is organized in three sections. You should read them
+ <p>This HOW-TO is organized in four sections. You should read them
sequentially because the later sections build upon the earlier ones.</p>
<ol>
<li>
The <link href="#sec3">third section</link> tells how to read
- non-standard properties. Non-standard properties are application-specific
- triples consisting of an ID, a type, and a value.
- </li>
+ non-standard properties. Non-standard properties are application-specific
+ triples consisting of an ID, a type, and a value.
+ </li>
+
+ <li>
+ The <link href="#sec4">fourth section</link> will tell you how to write
+ property set streams - once it is written. Writing is still quite
+ rudimentary in HPSF and you have to understand the <link
+ href="#sec3">third section</link> before you should think about writing
+ properties. Stick to the Javadoc API documentation to find out more about
+ writing property sets!
+ </li>
</ol>
<document>
<header>
- <title>Jakarta POI - HPSF - Java APIs with XML manipulate MS-Format Properties</title>
+ <title>Jakarta POI - HPSF - Java API to Handle Microsoft Format Document Properties</title>
<subtitle>Overview</subtitle>
<authors>
<person name="Rainer Klute" email="klute@apache.org"/>
</header>
<body>
<section><title>Overview</title>
+
<p>Microsoft applications like "Word", "Excel" or "Powerpoint" let the user
describe his document by properties like "title", "category" and so on. The
application itself adds further information: last author, creation date
streams</strong>. A property set stream is a separate document within a
<link href="../poifs/index.html">POI filesystem</link>. We'll call property
set streams mostly just "property sets". HPSF is POI's pure-Java
- implementation to read (and in future to write) property sets.</p>
+ implementation to read and property sets.</p>
<p>The <link href="how-to.html">HPSF HOWTO</link> describes what a Java
application should do to read a property set using HPSF and to retrieve the
<strong>property set stream</strong>.</p>
<p>This document describes the internal structure of a property set stream,
- i.e. the <strong>HPSF</strong>. It does
+ i.e. the <strong>HPSF</strong>. It does
not describe how a Microsoft Office document is organized internally and
how to retrieve a stream from it. See the <link
href="../poifs/index.html">POIFS documentation</link> for that kind of
<ol>
<li>
- Add writing capability for property sets. Presently property sets can
- be read only.
+ Improve writing support! We need convenience classes and methods for
+ easily writing summary information streams and document summary
+ information streams.
</li>
<li>
Add codepage support: Presently the bytes making out the string in a
</li>
<li>
Add WMF to <code>java.awt.Image</code> example code in <link
- href="thumbnails.html">Thumbnail
- HOW TO</link>.
+ href="thumbnails.html">Thumbnail HOW TO</link>.
</li>
</ol>
</section>
projects / poi.git / commitdiff