Release notes

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_91@358822 13f79535-47bb-0310-9956-ffa450edef68

2 files changed, 153 insertions, 24 deletions

diff --git a/README b/README
index 0c608fea3..ad179ded4 100644
--- a/README
+++ b/README
@@ -4,23 +4,6 @@ $Id$
   APACHE FOP  -  README
 ==============================================================================
 
-+----------------------------------------------------------------------------+
-|                                                                            |
-|                      **** IMPORTANT! ****                                  |
-|                                                                            |
-| This release is the first after a big redesign effort on the whole FOP     |
-| codebase. This release is to be considered ALPHA quality and it is         |
-| intended as a preview release encouraging people to take a look at the new |
-| version and to provide feedback to the developers. Please not only report  |
-| to us problems you might experience but also tell us if it works for you.  |
-| If you find out that this version works fine for you, you're welcome to    |
-| use it but please test it thoroughly as we don't consider this release     |
-| ready for every production environment. Please read the following page for |
-| more detailed information:                                                 |
-| http://xmlgraphics.apache.org/fop/0.90/upgrading.html                      |
-|                                                                            |
-+----------------------------------------------------------------------------+
-
 Contents of this file:
  - What is FOP?
  - Where to get help?
@@ -76,26 +59,32 @@ Simply by typing "fop" on the command-line. Without any parameters you
 will receive a screen with instruction on how to call FOP from the
 command-line.
 
-For more details, see: http://xmlgraphics.apache.org/fop/0.90/running.html
+For more details, see: http://xmlgraphics.apache.org/fop/latest/running.html
 
 ==============================================================================
   RELEASE NOTES
 ==============================================================================
 
-Version 0.90alpha1
+Version 0.91 beta
 ---------------------
 
 We don't list all the changes since the 0.20.5 release, since this release 
 represents the first after a complete redesign of the FOP codebase. This 
-is basically a new software.
+is basically a new software. But the changes since 0.90 alpha 1 can be looked
+up under http://xmlgraphics.apache.org/fop/changes.html.
 
 Upgrading from 0.20.5:
-Please read http://xmlgraphics.apache.org/fop/0.90/upgrading.html
+Please read http://xmlgraphics.apache.org/fop/latest/upgrading.html
+
+The Apache FOP team asks you for your continued feedback on the new software.
+We're also interested in success stories with the new release. So if the
+latest version works fine for you, please tell us! And if it doesn't, you
+may tell us as well, of course. ;-)
 
 Caveats:
 
-    - This release is a preview release and not intended for use in a
-      production environment. Use at your own risk!
+    - This release is a beta release. If you intend to use this software 
+      in a production environment, please perform careful testing.
     - The API is not to be considered stable, yet. Please be prepared 
       for the API to be changed in a backwards-incompatible way.
     - You may experience different behaviour compared to version 0.20.5.
@@ -148,3 +137,5 @@ Known issues:
       and attempting to create columns implicitly from the first
       table row is not implemented, yet (Bugzilla #35656).
     - Leaders with the "rule" pattern don't work for PostScript output.
+    - break-after may in some cases cause subsequent content to be swallowed. 
+      Please use break-before, if possible.
diff --git a/src/documentation/content/xdocs/relnotes.xml b/src/documentation/content/xdocs/relnotes.xml
index e7aafdd76..a65247d28 100644
--- a/src/documentation/content/xdocs/relnotes.xml
+++ b/src/documentation/content/xdocs/relnotes.xml
@@ -24,6 +24,144 @@
 
     <body>
 <section>
+  <title>FOP 0.91 beta</title>
+  <p>
+    This is the second release after the big redesign effort. FOP 0.91 beta is mostly a bug
+    fix release but also contains some new features.
+  </p>
+  <p>
+    We would like to encourage you to download the code and to play with it. 
+    We're still in the process of adding new major features and stabilizing 
+    the code. We welcome any feedback you might have and even more, any
+    other form of help to get the project forward.
+  </p>
+  <p>Caveats:</p>
+  <ul>
+    <li>
+      This release is an beta release. If you intend to use this software in a production
+      environment, please perform careful testing.
+    </li>
+    <li>
+      The API is not to be considered stable, yet. Please be prepared 
+      for the API to be changed in a backwards-incompatible way.
+    </li>
+    <li>
+      You may experience different behaviour compared to version 0.20.5.
+      Please consult the <a href="0.91/upgrading.html">"Upgrading"</a> page indicated above for details.
+    </li>
+  </ul>
+  <p>Known Issues:</p>
+  <ul>
+    <li>
+      PCL, MIF and SVG support have not been restored, yet.
+    </li>
+    <li>
+      Java2D/AWT support contains some problems, for example with 
+      block-containers.
+    </li>
+    <li>
+      Support for kerning has not been restored, yet.
+    </li>
+    <li>
+      Auto table layout is not implemented, yet.
+    </li>
+    <li>
+      The collapsing border model on tables is not implemented, yet. Please 
+      use border-collapse="separate" for now.
+    </li>
+    <li>
+      Footnotes may overlap with text of the region-body in multi-column 
+      documents.
+    </li>
+    <li>
+      Space resolution does not work between footnote regions.
+    </li>
+    <li>
+      There's a problem involving nested block-containers and 
+      reference-orientation 180/-180 (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36391">Bugzilla #36391</a>)
+    </li>
+    <li>
+      block-containers with no height currently don't create a fence for
+      spaces as they should (they behave like a normal block).
+    </li>
+    <li>
+      Preserved linefeeds in fo:character are not handled correctly.
+    </li>
+    <li>
+      Zero-width spaces are not handled correctly.
+    </li>
+    <li>
+      An empty block currently produces a fence for stacking constraints
+      which it shouldn't.
+    </li>
+    <li>
+      There are several small problems around white space handling.
+    </li>
+    <li>
+      Images currently don't shrink so they fit on a page when they are 
+      too big and shrinking is allowed to happen.
+    </li>
+    <li>
+      Block-level content in fo:inlines may produce unwelcome results.
+    </li>
+    <li>
+      inline-container may not work as expected.
+    </li>
+    <li>
+      letter-spacing and word-spacing properties may not work as expected.
+    </li>
+    <li>
+      leaders with leader-pattern="use-content" may not work as expected.
+    </li>
+    <li>
+      keep-with-previous doesn't work inside tables and lists, yet.
+    </li>
+    <li>
+      White space on direct inline-level children of a marker is not 
+      handled correctly.
+    </li>
+    <li>
+      If two consecutive pages don't have the same available width, the 
+      content currently isn't properly fit into the available space on
+      the new page.
+    </li>
+    <li>
+      background-images on page-number-citations are not placed correctly.
+    </li>
+    <li>
+      Not all FO elements can be referenced by their "id", most notably:
+      table-body, table-header, table-footer and table-row.
+    </li>
+    <li>
+      The backgrounds of table-body, table-header, table-footer and 
+      table-column are not painted, yet.
+    </li>
+    <li>
+      Border and padding conditionality are not supported on table-cells, yet.
+    </li>
+    <li>
+      Copy/Paste from PDF content in Acrobat Reader is not supported for
+      text using embedded TrueType fonts.
+    </li>
+    <li>
+      Column balancing in multi-column documents may not work as expected
+      (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36356">Bugzilla #36356</a>)
+    </li>
+    <li>
+      Omitting fo:table-column or having fo:table-column without a column-width 
+      and attempting to create columns implicitly from the first
+      table row is not implemented, yet (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=35656">Bugzilla #35656</a>).
+    </li>
+    <li>
+      Leaders with the "rule" pattern don't work for PostScript output.
+    </li>
+    <li>
+      break-after may in some cases cause subsequent content to be swallowed. 
+      Please use break-before, if possible.
+    </li>
+  </ul>
+</section>
+<section>
   <title>FOP 0.90 alpha 1</title>
   <p>
     This is the first preview release after the big redesign effort.
@@ -46,7 +184,7 @@
     </li>
     <li>
       You may experience different behaviour compared to version 0.20.5.
-      Please consult the <a href="0.90/upgrading.html">"Upgrading"</a> page indicated above for details.
+      Please consult the <a href="0.91/upgrading.html">"Upgrading"</a> page indicated above for details.
     </li>
   </ul>
   <p>Known Issues:</p>