You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by je...@apache.org on 2008/06/11 15:33:20 UTC
svn commit: r666662 - in
/xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs:
0.95/output.xml trunk/output.xml
Author: jeremias
Date: Wed Jun 11 06:33:20 2008
New Revision: 666662
URL: http://svn.apache.org/viewvc?rev=666662&view=rev
Log:
Some notes on RTF and print output.
Modified:
xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/0.95/output.xml
xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/trunk/output.xml
Modified: xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/0.95/output.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/0.95/output.xml?rev=666662&r1=666661&r2=666662&view=diff
==============================================================================
--- xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/0.95/output.xml (original)
+++ xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/0.95/output.xml Wed Jun 11 06:33:20 2008
@@ -703,6 +703,24 @@
<note>RTF output is currently unmaintained and lacks many features compared to other output
formats. Using other editable formats like Open Document Format, instead of producing XSL-FO
then RTF through FOP, might give better results.</note>
+ <p>
+ These are some known restrictions compared to other supported output formats (not a complete list):
+ </p>
+ <ul>
+ <li>
+ Not supported/implemented:
+ <ul>
+ <li>break-before/after (supported by the RTF library but not tied into the RTFHandler)</li>
+ <li>fo:leader</li>
+ <li>fo:page-number-citation(-last)</li>
+ <li>proportional-column-width() and percentages</li>
+ <li>nested tables (the flatter your FO, the better the results in RTF!)</li>
+ <li>keeps (supported by the RTF library but not tied into the RTFHandler)</li>
+ <li>region-start/end (RTF limitation)</li>
+ </ul>
+ </li>
+ <li>Only a single page-master is supported</li>
+ </ul>
</section>
<section id="xml">
<title>XML (Area Tree XML)</title>
@@ -735,6 +753,16 @@
It is possible to directly print the document from the command line.
This is done with the same code that renders to the Java2D/AWT renderer.
</p>
+ <section id="print-issues">
+ <title>Known issues</title>
+ <p>
+ If you run into the problem that the printed output is incomplete on Windows:
+ this often happens to users printing to a PCL printer.
+ There seems to be an incompatibility between Java and certain PCL printer drivers
+ on Windows. Since most network-enabled laser printers support PostScript, try
+ switching to the PostScript printer driver for that printer model.
+ </p>
+ </section>
</section>
<section id="bitmap">
<title>Bitmap (TIFF/PNG)</title>
Modified: xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/trunk/output.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/trunk/output.xml?rev=666662&r1=666661&r2=666662&view=diff
==============================================================================
--- xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/trunk/output.xml (original)
+++ xmlgraphics/fop/branches/fop-0_95/src/documentation/content/xdocs/trunk/output.xml Wed Jun 11 06:33:20 2008
@@ -703,6 +703,24 @@
<note>RTF output is currently unmaintained and lacks many features compared to other output
formats. Using other editable formats like Open Document Format, instead of producing XSL-FO
then RTF through FOP, might give better results.</note>
+ <p>
+ These are some known restrictions compared to other supported output formats (not a complete list):
+ </p>
+ <ul>
+ <li>
+ Not supported/implemented:
+ <ul>
+ <li>break-before/after (supported by the RTF library but not tied into the RTFHandler)</li>
+ <li>fo:leader</li>
+ <li>fo:page-number-citation(-last)</li>
+ <li>proportional-column-width() and percentages</li>
+ <li>nested tables (the flatter your FO, the better the results in RTF!)</li>
+ <li>keeps (supported by the RTF library but not tied into the RTFHandler)</li>
+ <li>region-start/end (RTF limitation)</li>
+ </ul>
+ </li>
+ <li>Only a single page-master is supported</li>
+ </ul>
</section>
<section id="xml">
<title>XML (Area Tree XML)</title>
@@ -735,6 +753,16 @@
It is possible to directly print the document from the command line.
This is done with the same code that renders to the Java2D/AWT renderer.
</p>
+ <section id="print-issues">
+ <title>Known issues</title>
+ <p>
+ If you run into the problem that the printed output is incomplete on Windows:
+ this often happens to users printing to a PCL printer.
+ There seems to be an incompatibility between Java and certain PCL printer drivers
+ on Windows. Since most network-enabled laser printers support PostScript, try
+ switching to the PostScript printer driver for that printer model.
+ </p>
+ </section>
</section>
<section id="bitmap">
<title>Bitmap (TIFF/PNG)</title>
@@ -886,3 +914,4 @@
</document>
+
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org