Author: jeremias
Date: Mon Aug 25 01:59:27 2008
New Revision: 688664

URL: http://svn.apache.org/viewvc?rev=688664&view=rev
Log:
Minor documentation improvements, most notably a comment about 
keep-together="always".

Modified:
    xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml
    xmlgraphics/fop/trunk/status.xml

Modified: xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml
URL: 
http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml?rev=688664&r1=688663&r2=688664&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml Mon Aug 25 
01:59:27 2008
@@ -592,8 +592,10 @@
         text flows into adjacent cells/block, obscuring stuff there.</question>
       <answer>
         <p>
-          Clipping as specified by the <code>overflow="hidden"</code> is not 
yet
-          implemented.  If you have long words overflowing table cells, try to
+          Since the <code>overflow</code> property doesn't apply to 
table-cell, you
+          can wrap the cell content in a block-container and specify
+          <code>overflow="hidden"</code> there. Alternatively,
+          if you have long words overflowing table cells, try to
           get them hyphenated. Artificial names like product identifications or
           long numbers usually aren't hyphenated. You can try special 
processing
           at XSLT level, like
@@ -615,6 +617,15 @@
           <link href="http://www.mulberrytech.com/xsl/xsl-list/";>XSL list
           archive</link> for how to perform these tasks.
         </p>
+        <p>
+          If your text is not hyphenated at all and overflows the cell, please 
check
+          if you've specified <code>keep-together="always"</code> on the 
table-cell
+          or one of its parent elements. <code>keep-together="always"</code> 
implicitely
+          also sets <code>keep-together.within-line="always"</code> which 
forbids FOP
+          to break the text into multiple lines. This is important as FOP 
supports inline-level
+          keeps since version 0.94. It's a good idea not to use the shorthand
+          <code>keep-together="always"</code> at all!
+        </p>
       </answer>
     </faq>
     <faq id="row-height-constraint">

Modified: xmlgraphics/fop/trunk/status.xml
URL: 
http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/status.xml?rev=688664&r1=688663&r2=688664&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/status.xml (original)
+++ xmlgraphics/fop/trunk/status.xml Mon Aug 25 01:59:27 2008
@@ -53,7 +53,7 @@
 
   <changes>
     <release version="FOP Trunk" date="TBD">
-      <action context="Code" dev="JM" type="fix">
+      <action context="Code" dev="JM" type="fix" importance="high">
         Fixed memory leak in property cache (not cleaning stale 
PropertyCache$CacheEntry instances).
       </action>
       <action context="Renderers" dev="JM" type="fix">
@@ -138,7 +138,7 @@
         Fixed a ClassCastException when using an fo:wrapper as a child
         of an fo:block-container.
       </action>
-      <action context="Fonts" dev="AC" type="add">
+      <action context="Fonts" dev="AC" type="add" importance="high">
         Add support for font substitution.
       </action>
       <action context="Renderers" dev="JM" type="fix" fixes-bug="43650">
@@ -161,7 +161,7 @@
         Add partial support for the "show-destination" property on 
fo:basic-link
         (PDF output only; see limitations on the compliance page)
       </action>
-      <action context="Layout" dev="JM" type="add">
+      <action context="Layout" dev="JM" type="add" importance="high">
         Added minimal support for integer keep values on the various keep 
properties on block-level
         FOs. For now, all integer values are treated the same (i.e. without 
strength distinction).
         Using integers allows to avoid overflows that can happen when "always" 
is used extensively.
@@ -189,7 +189,7 @@
         When a JPEG image is embedded, an optionally embedded color profile is 
filtered out
         as it's already embedded separately in the PDF file.
       </action>
-      <action context="Fonts" dev="JM" type="add">
+      <action context="Fonts" dev="JM" type="add" importance="high">
         Added support for addressing all glyphs available in a Type 1 font, 
not just the ones
         in the font's primary encoding.
       </action>
@@ -688,7 +688,7 @@
       <action context="Code" dev="JM" type="fix">
         AFP Renderer: Bugfix for 1 bit images where the width is not a 
multiple of 8.
       </action>
-      <action context="Code" dev="MM" type="add">
+      <action context="Code" dev="MM" type="add" importance="high">
         Support for keep-together.within-line="always".
       </action>
       <action context="Code" dev="MM" type="fix">



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to