documentation update for release 0.15

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@193838 13f79535-47bb-0310-9956-ffa450edef68

9 files changed, 35 insertions, 39 deletions

diff --git a/docs/xml-docs/fop/architecture.xml b/docs/xml-docs/fop/architecture.xml
index ac3d4d48d..bb4c00caa 100644
--- a/docs/xml-docs/fop/architecture.xml
+++ b/docs/xml-docs/fop/architecture.xml
@@ -98,7 +98,7 @@ constructing the FO tree. The key SAX events used are </p>
 
 <p><code>Block</code></p>
 <p><code>Inline</code></p>
-<p><code>SimpleLink</code></p>
+<p><code>BasicLink</code></p>
 
 </s2>
 
diff --git a/docs/xml-docs/fop/bugs.xml b/docs/xml-docs/fop/bugs.xml
index 388996391..01de7ffa4 100644
--- a/docs/xml-docs/fop/bugs.xml
+++ b/docs/xml-docs/fop/bugs.xml
@@ -15,14 +15,9 @@
        file with your report, which just demonstrates the problem. Thanks for your help!</p>
   </s2>
   <s2 title="Known bugs">
-    <ul>
-      <li>Colour not continued onto subsequent pages, if coloured block goes over page.</li>
-      <li>SVG linearGradients don't appear the same as in other SVG Viewers</li>
-      <li>colour not continued onto subsequent pages if coloured block goes over page </li>
-      <li>no SVG support in AWTCommandLine </li>
-      <li>keep-next doesn't work and doubles the text lines which should be moved to the next page</li>
-      <li>lists containing list do not keep their indentation correctly over a page boundary</li>
-    </ul>
+    <p>A list of known bugs can be found at the end of the file 
+       <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump> in the root 
+       of the Fop distribution.</p>
   </s2>
 </s1>
 
diff --git a/docs/xml-docs/fop/examples.xml b/docs/xml-docs/fop/examples.xml
index 25fb4899c..c2019a6d7 100644
--- a/docs/xml-docs/fop/examples.xml
+++ b/docs/xml-docs/fop/examples.xml
@@ -15,11 +15,9 @@
       </li>
       <li>normal.fo - a simple file showing the use of a 2 level of headings, normal text and a header.
       </li>
-      <li>table.fo - a simple table
+      <li>table.fo - some table examples 
       </li>
-      <li>list.fo - a simple list
-      </li>
-      <li>list2.fo - some list examples
+      <li>list.fo - a short tutorial how to use list fo's and properties
       </li>
       <li>images.fo - shows how to embed gif and jpg images into the xsl:fo file using external-graphic.
       </li>
@@ -28,7 +26,7 @@
       <li>extensive.fo - a longer test file containing a lot of different flow objects and properties. 
           A good candidate to test your bugfix or new Fop code. 
       </li>
-      <li>leader.fo - a very simple example of a rule
+      <li>leader.fo - shows different uses of fo:leader, p.e. as rule or in a table of content
       </li>
       <li>normalex.fo - shows the use of computed property values
       </li>
@@ -36,10 +34,10 @@
       </li>
       <li>instream.fo - shows the use of fo:instream-foreign-object together with svg 
       </li>
-      <li>inhprop.fo - shows the use of inherited property values
-      </li>
       <li>textdeko.fo - shows the use of the property textdecoration
       </li>
+      <li>readme.fo - uses an old version of Fop documentation for a longer example
+      </li>
       
       <li>Look also into the directory examples/svg. There you find some very extensive svg examples. 
           Just start makedoc.
diff --git a/docs/xml-docs/fop/implemented.xml b/docs/xml-docs/fop/implemented.xml
index 982611348..1773479b3 100644
--- a/docs/xml-docs/fop/implemented.xml
+++ b/docs/xml-docs/fop/implemented.xml
@@ -6,7 +6,7 @@
 <s1 title="Features">
   <s2 title="What's Implemented?">
       <p>The following formatting objects and properties of the xsl-fo 
-         working draft (12 October 2000) are implemented.Please have also a look at the 
+         candidate recommendation are implemented.Please have also a look at the 
          section on <jump href="limitations.html">limitations</jump>
       </p>
   </s2>
@@ -46,7 +46,7 @@
         <li>external-graphic</li>
         <li>inline</li>
         <li>instream-foreign-object</li>
-        <li>leader, but see <jump href="limitations.html">limitations</jump></li>
+        <li>leader</li>
         <li>page-number </li>
         <li>page-number-citation, see <jump href="limitations.html">limitations</jump></li>
       </ul>
@@ -145,6 +145,10 @@
       <li>initial-page-number</li>
       <li>internal-destination</li>
       <li>keep-with-next (broken)</li>
+      <li>leader-alignment (not value "page")</li>
+      <li>leader-length (no percentage values)</li>
+      <li>leader-pattern (not value "use-content")</li>
+      <li>leader-pattern-width</li>
       <li>left</li>
       <li>line-height </li>
       <li>margin-bottom (only on pages and regions) </li>
@@ -170,18 +174,19 @@
       <li>provisional-distance-between-starts </li>
       <li>provisional-label-separation </li>
       <li>ref-id </li>
+      <li>region-name</li>
       <li>right</li>
       <li>rule-thickness </li>
       <li>space-after.optimum </li>
       <li>space-before.optimum </li>
       <li>src </li>
       <li>start-indent </li>
-      <li>textdecoration (only value 'underline' is supported)</li>
+      <li>textdecoration (only value "underline")</li>
       <li>text-align </li>
       <li>text-align-last </li>
       <li>text-indent </li>
       <li>top</li>
-      <li>white-space-treatment (broken)</li>
+      <li>white-space-collapse</li>
       <li>width</li>
       <li>wrap-option</li>
     </ul>
diff --git a/docs/xml-docs/fop/involved.xml b/docs/xml-docs/fop/involved.xml
index e80a55b62..68742cce9 100644
--- a/docs/xml-docs/fop/involved.xml
+++ b/docs/xml-docs/fop/involved.xml
@@ -22,7 +22,7 @@
   </s2>
   <s2 title="Look at the developer's code using cvs">
   <p>Between releases the newest code can be accessed via cvs. To do this you need to install a cvs 
-     client on your computer if it is not already there. An explanation how to connect to the 
+     client on your computer, if it is not already there. An explanation how to connect to the 
      Fop source repository can be found at <jump href="http://xml.apache.org/cvs.html">http://xml.apache.org/cvs.html</jump>. 
      An introduction into cvs and the cvs manual can be found in the 
      <jump href="http://xml.apache.org/library.html">reference library</jump>.</p>
diff --git a/docs/xml-docs/fop/limitations.xml b/docs/xml-docs/fop/limitations.xml
index d4a88e966..d293c824d 100644
--- a/docs/xml-docs/fop/limitations.xml
+++ b/docs/xml-docs/fop/limitations.xml
@@ -9,13 +9,6 @@
      in <jump href="implemented.html">features</jump>, sometimes it does so only in a limited way. 
   </p>
 
-  <s2 title="leader">
-    <p>fo:leader is only supported in a very limited way: you can use it to draw simple rules. 
-       Only the property value leader-pattern="rule" is supported. leader-length can be set, 
-       but the value is not used. You should wrap leader into a block element.
-    </p>
-  </s2>
-
   <s2 title="page-number-citation">
     <p>Only works for table of contents without any problems. The case where the page number doesn't 
     fit on a line isn't handled, and any text on the same line and after the page-number might not 
diff --git a/docs/xml-docs/fop/readme.xml b/docs/xml-docs/fop/readme.xml
index 22c187e18..add186b17 100644
--- a/docs/xml-docs/fop/readme.xml
+++ b/docs/xml-docs/fop/readme.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" standalone="no"?>
 
 
-<!-- $Id$ -->
 <!-- 
   Authors:
    James Tauber
@@ -21,16 +20,22 @@
        like XT or Xalan) or can be passed in memory as a DOM Document or (in
        the case of XT) SAX events.
     </p>
-    <p>The latest version of Fop is 0.14 and it supports partially the xsl:fo working draft 
-       from March 2000. You can <jump href="download.html">download</jump> 
-       Fop including a precompiled version the source code and many example files to 
+    <p>The latest version of Fop is 0.15 and it supports the xsl:fo candidate release.
+       You can <jump href="download.html">download</jump> 
+       Fop including a precompiled version, the source code and many example files to 
        get you started. Pointers to introductions into xsl:fo can be found in the
-       section <jump href="specs.html">specifications</jump>. 
+       section <jump href="specs.html">specifications</jump>. Please be aware, that 
+       Fop is at the moment not a full implementation of the basic conformance level
+       of the xsl:fo standard. You can find a list of supported flow objects and properties
+       in the section <jump href="implemented.html">Features</jump> and in section 
+       <jump href="limitations.html">Limitations</jump> in what way this support is 
+       limited.
     </p>
     <p>FOP is part of Apache's XML project. The homepage of FOP is 
        <jump href="http://xml.apache.org/fop">http://xml.apache.org/fop</jump>. A list
        of known bugs, the committers to this project and the tasks they are working on can be found 
-       in the file <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump>
+       in the file <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump> in the
+       root of your Fop distribution.
     </p>
   </s2>
 
diff --git a/docs/xml-docs/fop/running.xml b/docs/xml-docs/fop/running.xml
index 11111c6ea..4eea85359 100644
--- a/docs/xml-docs/fop/running.xml
+++ b/docs/xml-docs/fop/running.xml
@@ -13,7 +13,7 @@
     </p>
     <p>c) Fop supports SVG (see <jump href="implemented.html">Features</jump> for further information) and
           needs the w3c.jar library. This library comes with Fop (xml-fop/lib) and must
-          be included in your classpath. The jar file w3c.jar is the compiled classes for the
+          be included in your classpath. The jar file w3c.jar contains the compiled classes for the
           java svg bindings with some other DOM classes that are used by the SVG DOM bindings.
           The source for the svg java binding classes can be found at - <jump href="http://www.w3.org/TR/2000/CR-SVG-20000802/java.html">
           SVG Java bindings</jump>, currently they correspond to the CR-SVG-20000802 specification document.
diff --git a/docs/xml-docs/fop/specs.xml b/docs/xml-docs/fop/specs.xml
index 558343b55..708e6935b 100644
--- a/docs/xml-docs/fop/specs.xml
+++ b/docs/xml-docs/fop/specs.xml
@@ -6,9 +6,8 @@
 <s1 title="FOP Relevant Specifications and Links">
   <s2 title="Specifications">
   <ul>
-    <li><jump href="http://www.w3.org/TR/WD-xsl/">Latest XSL-FO Working Draft (27 March 2000)</jump></li>
-    <li><jump href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO Working Draft (27 March 2000) provided by N. Grigoriev from RenderX</jump></li>
-    <li><jump href="http://www.w3.org/TR/1999/WD-xsl-19990421/">XSL-FO Working Draft 21 Apr 1999 </jump></li>
+    <li><jump href="http://www.w3.org/TR/2000/CR-xsl-20001121/">XSL-FO Candidate Recommendation (21 November 2000)</jump></li>
+    <li><jump href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO WD from October provided by N. Grigoriev from RenderX</jump></li>
     <li><jump href="http://www.w3.org/TR/SVG">Latest SVG Working draft</jump></li>
     <li><jump href="http://www.w3.org/TR/2000/CR-SVG-20000802/index.html">Supported SVG Candidate Recommendation</jump></li>
     <li><jump href="http://www.w3.org/TR/REC-xml">XML Recommendation</jump></li>
@@ -20,9 +19,10 @@
     <li><jump href="http://java.sun.com/products/jdk/1.1/docs/index.html">Java JDK 1.1 Documentation</jump></li>
   </ul>
   </s2>
-  <s2 title="Tutorials">
+  <s2 title="Tutorials/Articles">
     <ul>
       <li><jump href="http://www.ibiblio.org/xml/books/bible/updates/15.html">Elliotte Rusty Harold: Chapter 15 on xsl:fo from his excellent xml book</jump></li>
+      <li><jump href="http://www.sun.com/software/xml/developers/slides-dtd/">Paul Sandoz: Using formatting objects with the slides dtd</jump></li>
     </ul>
   </s2>
 </s1>