incubator-odf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r795353 - /websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html
Date Tue, 06 Sep 2011 03:42:31 GMT
Author: buildbot
Date: Tue Sep  6 03:42:31 2011
New Revision: 795353

Log:
Staging update by buildbot

Modified:
    websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html

Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html
(original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html
Tue Sep  6 03:42:31 2011
@@ -78,137 +78,423 @@
   <div id="contenta">
   
     <h1 class="title">Simple API Release Notes</h1>
-    <h2 id="what_is_the_simple_java_api_for_odf">What is the Simple Java API for ODF?</h2>
-<p>The Simple Java API for ODF is an easy-to-use, high-level Java API for creating,
modifying and extracting data from ODF 1.2 documents.  It is written in pure Java and does
not require that you install any document editor on your system.  The Simple Java API for
ODF is a high level abstraction of the lower-level <a href="http://incubator.apache.org/odftoolkit/odfdom/index.html">ODFDOM
API</a>.</p>
-<h2 id="new_release_066">New Release 0.6.6</h2>
-<p>We are pleased to announce the release of the Simple Java API for ODF version 0.6.6
on Auguest 12th. The improvements in this version include:</p>
-<ul>
-<li>Two critical bugs in the Navigation API are fixed, as well as
-    several other issues.</li>
-<li>Page columns,  a page layout feature in text documents, are supported.</li>
+    <h2 id="simple-api-release-notes"><strong>Simple API Release Notes</strong></h2>
+<p><strong>Release 0.6.6</strong><br />
+<em>Auguest 12th 2011</em></p>
+<p>We are pleased to announce the release of the Simple Java API for ODF version 0.6.6
today. The improvements in this version include:<br />
+</p>
+<ul>
+<li>Two critical bugs in Navigation API and several other issues are fixed.</li>
+<li>Page columns, a page layout feature in text document, are now supported.</li>
 <li>Unit test coverage rate increased.  This work improves the stability of our API.</li>
 </ul>
-<p>You can download it here. The full release notes can be found here. </p>
-<p>You are welcomed to give us any feedback by Bugzilla, eMail or forum. </p>
-<h2 id="project_roadmap_and_schedule">Project roadmap and schedule</h2>
-<p>The Simple Java API for ODF adhears to the "Release Early and Often" development
philosophy.  We will target a monthly release, for the end of each month.  Code that is ready
makes it into that month's release.  Code that is not yet ready will wait.</p>
-<p>Proposed Roadmap:</p>
-<ul>
-<li>Version 0.2 at the end of Oct, 2010 with the high-level methods
-    migrated from ODFDOM and organized in new package structure;</li>
-<li>Version 0.3 at the end of Nov, 2010 with high-level style API;</li>
-<li>Version 0.4 at the end of Jan, 2011 with additional high-level text methods;</li>
-<li>Version 0.5 at the end of March, 2011 with text box and fields methods;</li>
-<li>Version 0.6 at the end of May, 2011 with chart methods;</li>
-<li>Version 0.6.6 at the middle of August, 2011 with bugs fixed;</li>
-</ul>
-<p>More work will be started in Apache.</p>
-<h1 id="frequently_asked_questions">Frequently Asked Questions</h1>
-<h3 id="for_users">For Users</h3>
-<h4 id="how_to_download_and_install">How to download and install</h4>
-<p>You can get Simple Java API for ODF as binary distribution from the [http://odftoolkit.org/projects/simple/downloads
download] area. There you'll find Javadocs as well. To obtain source code, please refer to
[[#download_source|development section]]. </p>
-<h3 id="how_to_start_development">How to start development</h3>
-<p>I suggest you to start from an overview of this project. [[PackageLayer|This page]]
will give you an overall introduction of the package structures. After that, you can go to
the [http://simple.odftoolkit.org/cookbook/ Cookbook] and [http://simple.odftoolkit.org/ Demos]
to read some code samples. And then, you can start your own program to manipulate ODF document.</p>
-<p>If you are familar with ODFDOM, [http://odftoolkit.org/projects/simple/pages/PackageLayer#APIchanges
Here] are the API changes from ODFDOM.</p>
-<h3 id="prerequisites">Prerequisites</h3>
-<p>In addition to the Simple Java API JAR file you will need to download and install
the following runtime prerequisite:</p>
-<ul>
-<li>JDK version 1.6</li>
-<li>[https://oss.sonatype.org/content/groups/public/org/odftoolkit/odfdom-java/0.8.7/odfdom-java-0.8.7.jar
ODFDOM 0.8.7]</li>
-<li>The Apache Xerces 2.9.1 or higher version. (download from [http://xerces.apache.org/mirrors.cgi
Apache Xerces web site])</li>
-</ul>
-<h4 id="code_examples">Code examples</h4>
-<h1 id="you-can-find-sample-codes-from-our-httpsimpleodftoolkitorg-cookbook-and-httpsimpleodftoolkitorg-demos">You
can find sample codes from our [http://simple.odftoolkit.org/ Cookbook] and [http://simple.odftoolkit.org/
Demos].</h1>
-<p>The Simple Java API for ODF uses Bugzilla to track the defects. You can report defects
[http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id here].</p>
-<p>===For Developers===</p>
-<h3 id="how_to_download_source">How to download source</h3>
-<p>First, install [http://mercurial.selenic.com/wiki/ latest Mercurial]</p>
-<p>Second, setup Mercurial (optional):<br />Config file <Hg Install Dir>Mercurial.ini
on Windows or <Hg Install Dir>/.hgrc on Unix.
-Enhance the default configuration, using GIT diff and enable [http://mercurial.selenic.com/wiki/Win32TextExtension
default plugin] avoid different line breaks in the source.<br /></p>
-<div class="codehilite"><pre><span class="k">[ui]</span>
-<span class="na">username</span> <span class="o">=</span> <span
class="s">your Name &lt;yourLoginName@odftoolkit.org&gt;</span>
-<span class="c">;merge = your-merge-program (or internal:merge)</span>
-
-<span class="k">[diff]</span>
-<span class="na">git</span> <span class="o">=</span> <span class="s">1</span>
-
-<span class="k">[defaults]</span>
-<span class="na">diff</span><span class="o">=</span><span class="s">-p
-U 8</span>
-
-<span class="k">[extensions]</span>
-<span class="c"># Enables mercurial EOL extension for line break handling</span>
-<span class="c"># See http://mercurial.selenic.com/wiki/EolExtension (bundled since
1.5.4)</span>
-<span class="na">eol</span> <span class="o">=</span>
-
-<span class="c"># It&#39;ll remove unknown files and empty directories by default.
</span>
-<span class="c"># Usually you call &#39;hg update -C&#39; and &#39;hg purge&#39;
in sequence</span>
-<span class="c"># See http://mercurial.selenic.com/wiki/PurgeExtension  (bundled)</span>
-<span class="na">hgext.purge</span><span class="o">=</span>
-
-<span class="k">[eol]</span>
-<span class="c"># Converts mixed line ending within a file to LF (Unix) format </span>
-<span class="c"># before adding the file to the source repository</span>
-<span class="c"># See http://mercurial.selenic.com/wiki/EolExtension</span>
-<span class="na">only-consistent</span> <span class="o">=</span>
<span class="s">False</span>
-</pre></div>
-
-
-<p>Now, get the source code from the Simple project [http://www.selenic.com/mercurial/wiki/
Mercurial] repository. Please see below for a short introduction to using Mercurial on odftoolkit.org.
There's also a more general <a href="{{project help page SourceControl}}">help</a>
on how to use source control systems on odftoolkit.org. The command <br /><pre>
-hg clone https://hg.odftoolkit.org/hg/simple~code-base</pre>will download the repository
into a new directory. <br />Please note that by this you'll get the latest changeset.
If you for example want stable release 0.2, you may want to use<br /><pre>hg clone
https://odftoolkit.org/hg/simple~code-base -r v0.2</pre>Developers however always work
on the latest changeset.</p>
-<p>====How to build and run the unit tests=====
-After the source code is checked out, now get and install [http://maven.apache.org/ Apache
Maven]. On command line test your installation with "mvn -v".</p>
-<p>If Maven is correctly installed, change into the project directory and build with
command "mvn".</p>
-<p>==Communications==
-You can subscribe to the project's mailing lists from [http://odftoolkit.org/projects/simple/lists
this page].  The "users" list is for discussions about using the toolkit, and the "dev" list
is for discussing the development of the toolkit.  Active developers should also subscribe
to the "issues" and "commit" mailing lists so they will receive those automatic notifications.</p>
-<p>==Easy entry level tasks==
-TBD</p>
-<p>==<span id="Design_of_the_API">Design of the API</span>==
-The design principle is "make it easy for users to locate the functions they want".</p>
-<p>org.odftoolkit.simple.Document is the abstract base class which the specific document
classes are derived from:  TextDocument, SpreadsheetDocument, PresentationDocument, GraphicsDocument
and ChartDocument.</p>
-<p>For each document type  we have a subpackage that contain additional classes related
to that kind of documents.  So org.odftoolkit.simple.chart has classes related to chart, org.odftoolkit.simple.text
has classes related to text content,  and org.odftoolkit.simple.presentation has classes related
to presentation documents.</p>
-<p>Besides the packages for different document types, there are additional packages
defined for important common ODF features which are available across all kinds of documents,
such as table, meta and style. </p>
-<p>There is another package named org.odftoolkit.simple.common, which contains functions
that are not related with a specific document type nor a specific feature. For example, the
text extractor functions are put in this package.</p>
-<p>==How to contribute patches==
-If you want to contribute a patch to this project, following below steps:</p>
-<ul>
-<li>Step 1. Create an issue in
-    [http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id
-    bugzilla], or write a comment to a related open issue, to describe
-    what functions you want to provide.</li>
-<li>Step 2. Go through "[[#Design_of_the_API|Design of the API]]" to make sure your
contribution will follow it.</li>
-<li>Step 3. Check out the source code following the steps in [[#download_source|development
selection]], and add your
-    contribution codes, including the source code and the unit tests.
-    Every public method should have a corresponding unit test method.
-    The
-    [http://odftoolkit.org/projects/odfdom/pages/Development#Coding_Guidelines
-    code guidelines] are same as ODFDOM.</li>
-<li>Step 4. Test your contribution with Mecurial command to make sure all the unit
tests pass.  mvn</li>
-<li>Step 5. Generate a patch with hg commands.  hg commit -A -u "Developer:xxx" -m
"#bug XY# Description of changes"  hg export -a
-    -g -o ../myChanges.patch</li>
-<li>Step 6. Upload your patch to bugzilla.</li>
-<li>Step 7. Refactor your patch if you get comments from reviewers.</li>
-</ul>
-<h2 id="how_to_review_patches">How to review patches</h2>
-<p>As a reviewer, you need to carefully read the source code, run the unit tests, to
make sure the new contributed code won't hurt the quality of this project.
-<em>Step 1. Write a comment to [http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id
bugzilla], saying you would like to review this patch.
-</em>Step 2. Check out the source code following the steps in [[#download_source|development
selection]], and download the patch.
-<em>Step 3. Merge the patch to the source code with Mecurial command:
- hg import --no-commit ../someFile.patch
-</em>Step 4. Carefully read the code to make sure the code follows the "[[#Design_of_the_API|Design
of the API]]", the code can reach the goal and the code won't bring other problems.
-<em>Step 5. Carefully check the unit test code to make sure every public method has
been enough tested.
-</em>Step 6. Run the unit tests with Maven command to see if all the unit tests pass:
- mvn
-<em>Step 7. Write comment to bugzilla if you think anything needs to be improved.
-</em>Step 8. Repeat step 2 to 7 after the contributor improves the patch.
-*Step 9. Push the patch to repository with Mecurial command if you think the patch is good
enough:
- hg commit -A -u "Developer:xxx Reviewer:yyy" -m "#bug XY# Description of changes"
- hg push https://<your user id>:<your password>@odftoolkit.org/hg/simple~code-base</p>
-<h2 id="reference_material">Reference material</h2>
-<h3 id="odf">ODF</h3>
-<p>The current draft of the OASIS ODF 1.2 standard can be downloaded [http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office#odf12
here].</p>
-<h3 id="commands_line_tools">Commands line tools</h3>
-<p><em>[http://odftoolkit.org/projects/odfdom/pages/Development#Mercurial Here]
is a list of the most frequently used commands for Mercurial.
-</em>[http://odftoolkit.org/projects/odfdom/pages/Development#Maven Here] is a list
of the most frequently used commands for Maven.</p>
+<p>You can download it <a href="../downloads.html">here</a>.</p>
+<p>ODF Toolkit has been accepted as <a href="http://incubator.apache.org/projects/odftoolkit.html">Apache
incubator project</a> and the move process has been started. The security feature will
be included in Apache version. Thanks all of the contributors and users, please continue to
pay attention to us in Apache.</p>
+<p><strong><em>Resolved Issues</em></strong></p>
+<ul>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=334">Bug 334</a>
-  Paragraph.setStyleName() doesn't work.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=346">Bug 346</a>
-  Test don't work on Linux. </li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=347">Bug 347</a>
-  VariableField doen't register in Component cache.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=348">Bug 348</a>
-  Paragraph deleted is not complete.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=349">Bug 349</a>
-  Definition of the number of columns in the page and column Break.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=350">Bug 350</a>
-  TextNavigation find matched Selection out of range.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=353">Bug 353</a>
-  Matching child nodes not honored by Navigation if next sibling matches.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=354">Bug 354</a>
-  parameter isMinHeight is not taken into account in the method setHeight (class Row).</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=355">Bug 355</a>
-  StyleTypeDefinitions.HorizontalAlignmentType has a wrong value, 'justified' should be 'justify'.
</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=356">Bug 356</a>
-  Document.OdfMediaType.TEXT.toString() leads to unreachable code block.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=357">Bug 357</a>
-  getFontSizeInPoint() in TextProperties doesn't work.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=358">Bug 358</a>
-  TableCellTest.testCellSizeOptimal Unit test failing on MacOS.</li>
+</ul>
+<p><strong>Release 0.6.5</strong><br />
+<em>July 1st 2011</em></p>
+<p>We are pleased to announce the release of the Simple Java API for ODF version 0.6.5
today. The improvements in this version focus on paragraph and text documents. They are:<br
/>
+</p>
+<ul>
+<li>Hard page breaks, including append page break at the end of text document and append
page break after a reference paragraph.</li>
+<li>Headings, including append heading, apply plain text as heading.</li>
+<li>Comments, including add comment to a text selection, apply comment to a paragraph.</li>
+<li>Paragraph font, get/set paragraph font size, style, color and so on.</li>
+<li>Paragraph alignment, get/set paragraph text alignment.</li>
+<li>Hyperlinks, including navigation hyperlinks, apply hyperlink to a selection, append
hyperlink to paragraph. </li>
+</ul>
+<p>An interesting <a href="../demo/demo10.html">demo</a> is uploaded to
the website to show how to use these new features to format a text document. </p>
+<p><strong><em>Resolved Issues</em></strong><br />
+</p>
+<ul>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=341">Bug 341</a>
-  Component.getComponentByElement (OdfElement element) never return null.<br />
+</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=342">Bug 342</a>
-  TextProperties.getTextProperties throws NullPointerException. <br />
+</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=343">Bug 343</a>
-  OdfDocument.loadDocument(OdfPackage odfPackage, String internalPath) needs validate "internalPath".<br
/>
+</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=344">Bug 344</a>
-  Enhance hyperlink feature.<br />
+</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=345">Bug 345</a>
-  Supply Page Break, Heading, Comment, Paragraph Font and Alignment support.<br />
+</li>
+</ul>
+<p><strong><em>API changes since 0.6 Release</em></strong>
 <br />
+</p>
+<p>Method Change List <br />
+Note: The first column 'Java class' package is relative to 'org.odftoolkit'. <br />
+</p>
+<p>{|- border="1"
+!Previous Class
+!Previous Method
+!New Class
+!New Method
+|-
+|simple.text.Paragraph
+|TextPElement  getOdfElement()
+|simple.text.Paragraph
+|TextParagraphElementBase  getOdfElement()
+|-
+|simple.text.Paragraph
+|DefaultStyleHandler  getStyleHandler()
+|simple.text.Paragraph
+|ParagraphStyleHandler  getStyleHandler()
+|-
+|simple.text.Paragraph
+|Paragraph getInstanceof(TextPElement)
+|simple.text.Paragraph
+|Paragraph getInstanceof(TextParagraphElementBase)
+|}</p>
+<p><strong>Release 0.6</strong> <br />
+<em>June 1st 2011</em></p>
+<p>We are pleased to announce the release of the Simple Java API for ODF version 0.6
today. A major improvement of this version is the chart API. Now you can add charts to text,
spreadsheet and presentation documents with easy-to-use methods. An interesting <a href="../demo/demo9.html">demo</a>
is uploaded to the website to show how to create a presentation/text/spreadsheet document
with charts only using Simple ODF API. </p>
+<p>We also make some enhancements based on user requests:</p>
+<ul>
+<li>Ability to set table cell widths and heights with high precision;</li>
+<li>Ability to set validity rules for the values of table cells;</li>
+<li>Provide helper methods for Spreadsheet document to get table;</li>
+<li>Provide more layout definitions for slides</li>
+</ul>
+<p><strong><em>Resolved Issues</em></strong> </p>
+<ul>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=332">Bug 332</a>-
 Nice to have means to set table cell widths and heights with sub-millimeter precision.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=260">Bug 260</a>-
 Table cell validate function.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=243">Bug 243</a>-
 SpreadsheetDocument needs helper functions to get to Table.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=332">Bug 330</a>
-  Supply Chart API Features.</li>
+</ul>
+<p><strong><em>API changes since 0.5.5 Release</em></strong>
<br />
+</p>
+<p>Method Change List<br />
+Note: The first column 'Java class' package is relative to 'org.odftoolkit'.</p>
+<p>{|- border="1"
+!Previous Class
+!Previous Method
+!New Class
+!New Method
+|-
+|simple.table.Table
+|long getWidth()
+|simple.table.Table
+|double getWidth()
+|-
+|simple.table.Table
+|void setWidth(long)
+|simple.table.Table
+|void setWidth(double)
+|-
+|simple.table.Column
+|long getWidth()
+|simple.table.Column
+|double getWidth()
+|-
+|simple.table.Column
+|void  setWidth(long)
+|simple.table.Column
+|void  setWidth(double)
+|-
+|simple.table.Row
+|long getHeight()
+|simple.table.Table
+|double getHeight()
+|-
+|simple.table.Table
+|void setHeight(long)
+|simple.table.Table
+|void setHeight(double)
+|}</p>
+<p><strong>Release 0.5.5</strong>  <br />
+<em>April 30th 2011</em> <br />
+</p>
+<p>We released the Simple Java API for ODF  version 0.5.5 today. In this version, we
provide high level methods for image and text span. Now you can add images to text, spreadsheet
and presentation documents. The position of the image can be specified by a rectangle, a paragraph
or a cell. With text span, you can set a different style to a small unit of the text content.
An interesting <a href="../demo/demo8.html">demo</a> has been upload to website
to demonstrate how to add a 2D barcode image to a presentation slide.</p>
+<p>We also made some useful enhancements based on user requests: <br />
+</p>
+<ul>
+<li>automatically adjust the table column width based on its text content</li>
+<li>allow several paragraphs to be added to a single cell</li>
+<li>set whether or not a header/footer is visible</li>
+<li>optimize some table methods to improve performance</li>
+</ul>
+<p><strong><em>Resolved Issues</em></strong> </p>
+<ul>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=256">Bug 256</a>-
 JavaDoc should be deployed via Maven to the Simple website.<br />
+</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=269">Bug 269</a>-
 Desirable column width is calculated in characters on the basis of the size of the data that
will go into the table.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=273">Bug 273</a>-
 The performance of getRowList/getColumnList is too low, if there is a row element with 65535
repeat number.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=309">Bug 309</a>-
 Supply method to set the header/footer visible or not.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=311">Bug 311</a>-
 Insert several paragraphs in a cell or several different text in the same paragraph in a
cell. </li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=312">Bug 312</a>-
 Allow to set alignment of image in a table cell. </li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=326">Bug 326</a>-
 Something is missing in order to move the object on the sheet.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=327">Bug 327</a>-
 Problem with the adding of tables in Footer.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=328">Bug 328</a>-
 Performance problem in CellRange constructor when Table.getRowCount() is large.</li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=329">Bug 329</a>-
 Unable to set the column widths of a table with precision. </li>
+<li><a href="https://odftoolkit.org/bugzilla/show_bug.cgi?id=333">Bug 333</a>-
 Provide convenient methods for image and text span.</li>
+</ul>
+<h1 id="api-changes-since-05-release"><strong><em>API changes since 0.5
Release</em></strong></h1>
+<p>Note: The first column 'Java class' package is relative to 'org.odftoolkit'.</p>
+<p>{|- border="1"
+!Previous Class
+!Previous Method
+!New Class
+!New Method
+|-
+|simple.table.Cell
+|void  setImage(URI)
+|simple.table.Cell
+|Image  setImage(URI)
+|-
+|simple.table.Cell
+|Image  getImage()
+|simple.table.Cell
+|BufferedImage  getBufferedImage()
+|}</p>
+<p><strong>Release 0.5</strong> <br />
+<em>April 2nd 2011</em> <br />
+</p>
+<p>We released the Simple Java API for ODF  version 0.5 today.</p>
+<p>In this version, we provides paragraph, field, and text box manipulation methods.

+ - Paragraph methods allow you to create paragraph, get paragraph by index, set the text
content, and remove paragraph.
+ - Fields methods allow you to easily add a field to a document, and change the value of
a field. We now support data field, time field, chapter field, title field, subject field,
author field, page number field, page count field, etc. 
+ - Text box methods allow you to add a text box, change the content of text box, and delete
a text box.<br />
+You can implement powerful document generation scenarios with these API. You can get sample
codes from the cookbook for paragraph, field and text box.</p>
+<p><strong><em>Resolved Issues</em></strong></p>
+<ul>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=307 Bug 307] -  Table.getColumnByIndex()
throws NullPointerException.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=308 Bug 308] -  Remove padding
from table in header/footer.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=314 Bug 314] -  Navigation API
should support find/replace in a specific OdfElement range</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=315 Bug 315] -  Add Field API
to Simple ODF</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=316 Bug 316] -  Access to header
and footer to Standard and First Page.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=317 Bug 317] -  Table.getColumnCount()
doesn't work when exists table:table-columns</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=318 Bug 318] -  Provide paragraph
functions and its style handling functions.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=319 Bug 319] -  Provide frame
and text box API.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=320 Bug 320] -  Section should
provide methods to access paragraph.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=323 Bug 323] -  VariableContainer
should have a method to get its VariableFields.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=324 Bug 324] -  Table unnamed
causes a NullPointerException.</li>
+</ul>
+<h1 id="api-changes-since-045-release"><strong><em>API changes since 0.4.5
Release</em></strong></h1>
+<p>Note: The first column 'Java class' package is relative to 'org.odftoolkit'.</p>
+<p>{|- border="1"
+!Previous Class
+!Previous Method
+!New Class
+!New Method
+|-
+|simple.table.CellStyleHandler
+|getCellStyleElementForRead()
+|simple.style.DefaultStyleHandler
+|getStyleElementForRead()
+|-
+|simple.table.CellStyleHandler
+|getCellStyleElementForWrite()
+|simple.style.DefaultStyleHandler
+|getStyleElementForWrite()
+|}</p>
+<p><strong>Release 0.4.5</strong> <br />
+<em>March 4th 2011</em>  <br />
+</p>
+<p>We are pleased to announce the release of the Simple Java API for ODF version 0.4.5.
  Major changes in this release include:</p>
+<ul>
+<li>We are now using ODFDOM 0.8.7 </li>
+<li>We have added initial support  for footers and headers. Now you can simply get
the footer and header of text document and add table/image/string content to footer and header.
</li>
+<li>We have also improved the performance of copying slides from other presentations
(foreign slides). The time to copy a single slide is decreased by 20%, and the time to copy
slides with referenced resources is decreased much more. A sample to show the function of
copying slides from foreign documents is available in the [http://simple.odftoolkit.org/demo/demo5.html
website]. </li>
+</ul>
+<p><strong><em>Resolved Issues</em></strong></p>
+<ul>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=224 Bug 224] -  Setting note for
individual cell</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=254 Bug 254] -  Update Simple
API to support ODFDOM 0.8.7</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=274 Bug 274] -  Create row/column/cell
with/without repeat number</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=275 Bug 275] -  Append row/column
with/without previous row/column style</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=276 Bug 276] -  Cell format type
can be auto calculated according to the style of cell</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=278 Bug 278] -  Adding border
to created cell, OutOfMemoryError was throwed about 11,000 records</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=284 Bug 284] -  Cell.getFont()
throws NullPointerException</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=290 Bug 290] -  Table API doesn't
work for Presentation Document </li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=295 Bug 295] -  The Simple API
does not work with JDK5</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=303 Bug 303] -  Performance tuning
for foreign slide copy</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=304 Bug 304] -  Support image
and text in footer and header</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=305 Bug 305] -  A bug that occurs
when resizing the column width of a table to 0</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=306 Bug 306] -  Errors when Locale
is set to Germany</li>
+</ul>
+<p>There is no API changes in this version.</p>
+<p><strong>Release 0.4</strong><br />
+<em>January 31st 2011</em>  <br />
+</p>
+<p>We are pleased to announce that we are releasing version 0.4 of the Simple Java
API for ODF today. In this version, we have added powerful list functions. With these new
methods, you can easily add lists to text document and presentation document, with numbering,
bullets, or graphic bullets. An interesting code sample of this API is available in the [http://simple.odftoolkit.org/demo/demo4.html
website]. </p>
+<p>We have also introduced methods to get, copy and paste sections in text documents.
 Copying and pasting sections are useful when you want to clone a section of a template multiple
times for different data. The introduce of list and section functions has been added to [http://simple.odftoolkit.org/cookbook/Manipulate%20Text%20Document.html#Manipulate%20Section
Cookbook] for your reference.</p>
+<p>Also, along with various bug fixes we have greatly improved the performance of the
table API. Now creating a large table by adding one row after another is 20 times faster than
before. </p>
+<p>There is no API changes in this version.</p>
+<p><strong><em>Resolved Issues</em></strong></p>
+<ul>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=279 Bug 279] -  The performance
of Table API need enhance, some methods cost too much time</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=280 Bug 280] -  Supply List API
Support in Simple API</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=285 Bug 285] -  Supply text through
line and under line setting support to Font</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=291 Bug 291] -  Provide high level
methods for section</li>
+</ul>
+<p><strong>Release 0.3.5</strong><br />
+<em>December 24th 2010</em>  <br />
+</p>
+<p>Today we released a new version of the Simple Java API for ODF:  Release 0.3.5.
In this version, we have improved the navigation, text extraction, table and style handling
features by fixing bugs and improving the JavaDoc. We also fixed a memory leak issue related
to tables.</p>
+<p>You may notice that there are no new features in this month's release.  Our intent
is to alternate "bug fixing" releases with "new feature" release.  So next month will be a
new feature release (0.4) followed by a bug fixing release (0.4.5), etc.</p>
+<p><strong><em>Resolved Issues</em></strong></p>
+<ul>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=250 Bug 250] -  Table.newTable(Document
document, int numRows, int numCols) does not work well<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=251 Bug 251] -  Table.appendRows
throws ClassCastException<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=253 Bug 253] -  Column.setWidth()
don't work for new created table<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=255 Bug 255] -  cell.setFormatString()
and column.setWidth() throw exceptions<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=258 Bug 258] -  Where documentation
says "deprecated" new preferred way should be given<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=259 Bug 259] -  Setting font style
to a spreadsheet cell is incorrectly inherited<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=261 Bug 261] -  JavaDoc for the
TextExtractor needs a lot more prose<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=262 Bug 262] -  JavaDoc for TextNavigation
match() method is confusing<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=266 Bug 266] -  hasNext() method
of TextNavigation apparently is REQUIRED and should not be<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=267 Bug 267] -  String returned
by TextExtractor.getText() has a carriage return (ASCII 13) at the start<br />
+</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=271 Bug 271] -  Comments of Table
Style API</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=272 Bug 272] -  Static Map variables
in Table lead memory leak</li>
+</ul>
+<h1 id="api-changes-since-03-release"><strong><em>API changes since 0.3
Release</em></strong></h1>
+<p>The enum's defined in org.odftoolkit.simple.style.StyleTypeDefinitions have changed.
The prefix "Simple" has been removed.</p>
+<p>Note: The first column 'Java class' package is relative to 'org.odftoolkit.simple'.</p>
+<p>{|- border="1"
+!Class
+!Enum Previous name
+!Enum New name
+|-
+|org.odftoolkit.simple.style.StyleTypeDefinitions
+|SimpleFontStyle
+|FontStyle
+|-
+|
+|SimpleHorizontalAlignmentType
+|HorizontalAlignmentType
+|-
+|
+|SimpleVerticalAlignmentType
+|VerticalAlignmentType
+|-
+|
+|SimpleCellBordersType
+|CellBordersType
+|}</p>
+<p>=====Method name change list=====
+Note: The first column 'Java class' package is relative to 'org.odftoolkit.simple'.</p>
+<p>{|- border="1"
+!Class
+!Previous method
+!New method
+|-
+|common.navigation.Navigation
+|getCurrentItem()
+|nextSelection()
+|-
+|common.navigation.TextNavigation
+|getCurrentItem()
+|nextSelection()
+|-
+|common.navigation.TextStyleNavigation
+|getCurrentItem()
+|nextSelection()
+|-
+|style.Font
+|setSimpleFontStyle(StyleTypeDefinitions$SimpleFontStyle)
+|setFontStyle(StyleTypeDefinitions$FontStyle)
+|-
+|
+|StyleTypeDefinitions$SimpleFontStyle  getSimpleFontStyle()
+|StyleTypeDefinitions$FontStyle  getFontStyle()
+|}</p>
+<p>=====Method deleted=====
+The locale handling methods in org.odftoolkit.simple.style.Font have been removed in order
to simplify the API. Users who want to use advanced functions can use the suggested substitute.</p>
+<p>Note: The first column 'Java class' package is relative to 'org.odftoolkit.simple'.</p>
+<p>{|- border="1"
+!Class
+!deleted method
+!suggested substitute
+|-
+|style.Font
+|Locale setLocale()
+|CellStyleHandler.setFont(Font font, Locale language)
+|-
+|style.Font
+|Locale getLocale()
+|CellStyleHandler.getCountry(ScriptType type),CellStyleHandler.getLanguage(ScriptType type)
+|}</p>
+<p><strong>Release 0.3</strong><br />
+<em>December 1st 2010</em>  <br />
+</p>
+<p>We are pleased to announce the 2nd release of the Simple Java API for ODF.  In this
release. we provided easy-to-use functions for setting the text and border styles in tables,
as a first taste of a high-level style API. </p>
+<p>We also enhanced the navigation functions. Now the navigation functions work for
text, spreadsheet, presentation and chart document. [http://simple.odftoolkit.org/sample/demo3.html
An instructive sample]  has been added to the website to demonstrate these powerful functions.
</p>
+<p>There are also a few updates in table cell functions: some functions are enhanced
and some functions are marked as "Deprecated". More details are described below.</p>
+<p><strong><em>Resolved Issues</em></strong> <br />
+</p>
+<ul>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=246 Bug 246] -  Extend the navigation
API under simple.text.search to spreadsheet and presentation.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=247 Bug 247] -  Provide table
methods for presentation document.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=248 Bug 248] -  setHorizontalAlignment
and setVerticalAlignment do not work for new created table.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=249 Bug 249] -  getRowCount()
doesn't work if table:table-rows or table:table-group exits.</li>
+<li>[https://odftoolkit.org/bugzilla/show_bug.cgi?id=252 Bug 252] -  Provide high level
style methods for table. </li>
+</ul>
+<h1 id="api-changes-since-02-release"><strong><em>API changes since 0.2
Release</em></strong></h1>
+<p>Note: The first column 'Java class' package is relative to 'org.odftoolkit'.</p>
+<p>{|- border="1"
+!Previous Package
+!Previous Class
+!New Package
+!New Class
+|-
+|simple.text.search
+|Navigation
+|simple.common.navigation
+|Navigation
+|-
+|
+|Selection
+|
+|Selection
+|-
+|
+|TextNavigation
+|
+|TextNavigation
+|-
+|
+|TextSelection
+|
+|TextSelection
+|-
+|
+|TextStyleNavigation
+|
+|TextStyleNavigation
+|-
+|
+|InvalidNavigationException
+|
+|InvalidNavigationException
+|}</p>
+<p><strong>Release 0.2</strong> <br />
+</p>
+<p>Simple Java API for ODF 0.2 has been released on Nov 1th, with table, presentation,
and metadata convenient methods moved from ODFDOM into a new package structure. Better documents
are provided in this release. The cookbook, JavaDoc and demo codes can be found. You can download
the binary jar file from downloads page.</p>
+<p>Go to PackageLayer to get an overall introduction of package structure and the API
changes from ODFDOM.</p>
   </div>
 
   <div id="footera">



Mime
View raw message