From 2466f253400d1ec0f7c4bc6f68a8dab87a3ab87e Mon Sep 17 00:00:00 2001
From: Jeremias Maerki <jeremias@apache.org>
Date: Mon, 11 Sep 2006 18:24:35 +0000
Subject: Implemented limited support for extension properties through new
 methods on ElementMapping (backwards-compatible). Moved
 block-progression-unit into the fox: namespace. Implemented new extension
 properties: fox:orphan-content-limit and fox:widow-content-limit for fo:table
 and fo:list-block. See documentation for details. Bugfix in
 ElementListUtils.removeLegalBreaks (concerning box/glue combinations). Added
 a unit test to cover the problem.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@442282 13f79535-47bb-0310-9956-ffa450edef68
---
 .../content/xdocs/trunk/extensions.xml             | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

(limited to 'src/documentation/content')

diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml
index e2d19eca8..0c22ca123 100644
--- a/src/documentation/content/xdocs/trunk/extensions.xml
+++ b/src/documentation/content/xdocs/trunk/extensions.xml
@@ -51,8 +51,11 @@
           <code>http://xml.apache.org/fop/extensions</code> to the root element:
         </p>
         <source><![CDATA[<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
-               xmlns:fox="http://xml.apache.org/fop/extensions">]]></source>
-        <note>Currently, no extensions are implemented in FOP Trunk which use the FOP extension namespace.</note>
+               xmlns:fox="http://xmlgraphics.apache.org/fop/extensions">]]></source>
+        <note>
+          Currently, no extension elements are implemented in FOP Trunk which use the 
+          FOP extension namespace.
+        </note>
       </section>
       <section id="bookmarks">
         <title>PDF Bookmarks</title>
@@ -101,6 +104,21 @@ to following pages. Here is an example of FO code creating such a table-header:<
   </fo:table-row>
 </fo:table-header>]]></source-->
       </section>
+      <section id="widow-orphan-content-limit">
+        <title>fox:orphan-content-limit and fox:widow-content-limit</title>
+        <p>
+          The two proprietary extension properties, fox:orphan-content-limit and
+          fox:widow-content-limit, are used to improve the layout of list-blocks and tables.
+          If you have a table with many entries, you don't want a single row to be left over
+          on a page. You will want to make sure that at least two or three lines are kept
+          together. The properties take an absolute length which specifies the area at the
+          beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a
+          table or list-block. The properties are inherited and only have an effect on fo:table
+          and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure
+          the you'll have at least three lines (assuming line-height="1.2") together on a table
+          or list-block.
+        </p>
+      </section>
     </section>
   </body>
 </document>
-- 
cgit v1.2.3