From f02d9c1b949d496bd72a840e22d50ae5b3581499 Mon Sep 17 00:00:00 2001
From: Simon Pepping
Date: Sun, 7 Jan 2007 13:19:45 +0000
Subject: [PATCH] Merging changes from branch fop-0.93 back into trunk, change
year 2006 in build.xml into 2007, remove PCL from unsupported output formats
in known issues
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@493717 13f79535-47bb-0310-9956-ffa450edef68
---
README | 141 ++--
build.xml | 4 +-
fop.bat | 2 +-
forrest.properties | 1 +
known-issues.xml | 102 +++
...apshot.jar => xmlgraphics-commons-1.1.jar} | Bin 296933 -> 301249 bytes
lib/xmlgraphics-commons.NOTICE.txt | 5 +-
src/documentation/content/.htaccess | 44 +-
src/documentation/content/doap.rdf | 10 +-
.../content/xdocs/0.20.5/anttask.xml | 2 +-
.../content/xdocs/0.20.5/compiling.xml | 2 +-
.../content/xdocs/0.20.5/configuration.xml | 2 +-
.../content/xdocs/0.20.5/embedding.xml | 2 +-
.../content/xdocs/0.20.5/extensions.xml | 2 +-
.../content/xdocs/0.20.5/fonts.xml | 2 +-
.../content/xdocs/0.20.5/graphics.xml | 2 +-
.../content/xdocs/0.20.5/hyphenation.xml | 2 +-
.../content/xdocs/0.20.5/output.xml | 2 +-
.../content/xdocs/0.20.5/pdfencryption.xml | 2 +-
.../content/xdocs/0.20.5/running.xml | 2 +-
.../content/xdocs/0.20.5/servlets.xml | 2 +-
.../content/xdocs/0.92/output.xml | 401 ---------
.../content/xdocs/{0.92 => 0.93}/anttask.xml | 35 +-
.../xdocs/{0.92 => 0.93}/compiling.xml | 0
.../xdocs/{0.92 => 0.93}/configuration.xml | 42 +
.../xdocs/{0.92 => 0.93}/embedding.xml | 0
.../xdocs/{0.92 => 0.93}/extensions.xml | 22 +-
.../content/xdocs/{0.92 => 0.93}/fonts.xml | 0
.../content/xdocs/{0.92 => 0.93}/graphics.xml | 6 -
.../xdocs/{0.92 => 0.93}/hyphenation.xml | 0
.../content/xdocs/{0.92 => 0.93}/index.xml | 15 +-
.../xdocs/{0.92 => 0.93}/intermediate.xml | 0
.../content/xdocs/0.93/output.xml | 772 +++++++++++++++++
.../content/xdocs/{0.92 => 0.93}/pdfa.xml | 28 +-
.../xdocs/{0.92 => 0.93}/pdfencryption.xml | 0
src/documentation/content/xdocs/0.93/pdfx.xml | 136 +++
.../content/xdocs/{0.92 => 0.93}/running.xml | 0
.../content/xdocs/{0.92 => 0.93}/servlets.xml | 0
.../xdocs/{0.92 => 0.93}/upgrading.xml | 38 +-
src/documentation/content/xdocs/bugs.xml | 2 +-
.../content/xdocs/compliance.ihtml | 798 +++++++++---------
src/documentation/content/xdocs/download.xml | 8 +-
src/documentation/content/xdocs/examples.xml | 2 +-
src/documentation/content/xdocs/faq.xml | 71 +-
src/documentation/content/xdocs/fo.xml | 4 +-
src/documentation/content/xdocs/index.xml | 4 +-
.../content/xdocs/knownissues.xml | 6 +-
src/documentation/content/xdocs/license.xml | 2 +-
src/documentation/content/xdocs/news.xml | 11 +-
src/documentation/content/xdocs/relnotes.xml | 8 +-
src/documentation/content/xdocs/site.xml | 15 +-
src/documentation/content/xdocs/status.xml | 73 +-
src/documentation/content/xdocs/tabs.xml | 4 +-
.../content/xdocs/trunk/anttask.xml | 35 +-
.../content/xdocs/trunk/graphics.xml | 6 -
.../content/xdocs/trunk/index.xml | 13 +-
.../content/xdocs/trunk/output.xml | 5 +-
.../content/xdocs/trunk/pdfencryption.xml | 0
.../content/xdocs/trunk/upgrading.xml | 38 +-
.../stylesheets/changes2document.xsl | 3 +-
.../stylesheets/known-issues2document.xsl | 49 ++
.../stylesheets/releaseNotes2document.xsl | 4 +-
src/documentation/sitemap.xmap | 7 +
status.xml | 45 +-
64 files changed, 1928 insertions(+), 1113 deletions(-)
create mode 100644 known-issues.xml
rename lib/{xmlgraphics-commons-1.1-snapshot.jar => xmlgraphics-commons-1.1.jar} (91%)
mode change 100755 => 100644 src/documentation/content/xdocs/0.20.5/pdfencryption.xml
delete mode 100644 src/documentation/content/xdocs/0.92/output.xml
rename src/documentation/content/xdocs/{0.92 => 0.93}/anttask.xml (87%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/compiling.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/configuration.xml (86%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/embedding.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/extensions.xml (80%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/fonts.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/graphics.xml (97%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/hyphenation.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/index.xml (75%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/intermediate.xml (100%)
create mode 100644 src/documentation/content/xdocs/0.93/output.xml
rename src/documentation/content/xdocs/{0.92 => 0.93}/pdfa.xml (85%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/pdfencryption.xml (100%)
mode change 100755 => 100644
create mode 100644 src/documentation/content/xdocs/0.93/pdfx.xml
rename src/documentation/content/xdocs/{0.92 => 0.93}/running.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/servlets.xml (100%)
rename src/documentation/content/xdocs/{0.92 => 0.93}/upgrading.xml (79%)
mode change 100755 => 100644 src/documentation/content/xdocs/trunk/pdfencryption.xml
create mode 100644 src/documentation/resources/stylesheets/known-issues2document.xsl
diff --git a/README b/README
index a31247373..4f66c558b 100644
--- a/README
+++ b/README
@@ -69,10 +69,11 @@ Please report bugs to bugzilla at http://issues.apache.org/bugzilla/
How do I build FOP?
----------------------
-If you've downloaded a binary distribution, you don't need to build FOP.
+If you've downloaded a binary distribution, you don't need to build
+FOP.
Otherwise, please follow the instructions found here:
-http://xmlgraphics.apache.org/fop/latest/compiling.html
+http://xmlgraphics.apache.org/fop/stable/compiling.html
How do I run FOP?
@@ -82,84 +83,74 @@ 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/latest/running.html
+For more details, see:
+http://xmlgraphics.apache.org/fop/stable/running.html
==============================================================================
RELEASE NOTES
==============================================================================
-Version 0.92 beta
----------------------
-
-We don't list all the changes since the 0.20.5 release, since the codebase
-was practically rewritten in large areas as part of a big redesign effort.
-This 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/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 beta release. If you intend to use this software
- in a production environment, please perform careful testing.
- - With the latest changes, the API is now considered stable. Please
- note that the API has changed in a backwards-incompatible way since
- the last release.
- - You may experience different behaviour compared to version 0.20.5.
- Please consult the "Upgrading" page indicated above for details.
-
-Known issues:
-
- - PCL, MIF and SVG support have not been restored, yet.
- - Java2D/AWT support contains some problems, for example with
- block-containers.
- - Auto table layout is not implemented, yet.
- - The collapsing border model on tables is not implemented, yet. Please
- use border-collapse="separate" for now.
- - Footnotes may overlap with text of the region-body in multi-column
- documents.
- - Space resolution does not work between footnote regions.
- - There's a problem involving nested block-containers and
- reference-orientation 180/-180 (Bugzilla #36391)
- - block-containers with no height currently don't create a fence for
- spaces as they should (they behave like a normal block).
- - Preserved linefeeds in fo:character are not handled correctly.
- - An empty block currently produces a fence for stacking constraints
- which it shouldn't.
- - There are several small problems around white space handling.
- - Images currently don't shrink so they fit on a page when they are
- too big and shrinking is allowed to happen.
- - Block-level content in fo:inlines may produce unwelcome results.
- - inline-container may not work as expected.
- - leaders with leader-pattern="use-content" may not work as expected.
- - keep-with-previous doesn't work inside tables and lists, yet.
- - White space on direct inline-level children of a marker is not
- handled correctly.
- - 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.
- - background-images on page-number-citations are not placed correctly.
- - Not all FO elements can be referenced by their "id", most notably:
- table-body, table-header, table-footer and table-row.
- - The backgrounds of table-body, table-header, table-footer and
- table-column are not painted, yet.
- - Border and padding conditionality are not supported on table-cells, yet.
- - Copy/Paste from PDF content in Acrobat Reader is not supported for
- text using embedded TrueType fonts.
- - Column balancing in multi-column documents may not work as expected
- (Bugzilla #36356)
- - 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 (Bugzilla #35656).
- - Internal basic-links don't point to the exact location on a page, yet,
- as they did in 0.20.5. Currently you land in the upper left corner of
- the page.
+Version 0.93
+============
+
+This is the first production grade release of the new FOP codebase.
+
+* It contains the new API first introduced in release 0.92
+ beta. The preceding API has been removed.
+* This release again contains many bug fixes and new features. See
+ below for details.
+
+Compliance
+----------
+
+This release implements the XSL 1.0 and 1.1 recommendations to a high
+degree of compliance. See the compliance page
+http://xmlgraphics.apache.org/fop/compliance.html for a detailed
+overview.
+
+Known issues
+------------
+
+The known issues of this release are listed at
+http://xmlgraphics.apache.org/fop/knownissues.html.
+
+Upgrading
+---------
+
+You may experience different behaviour compared to version
+0.20.5. Please consult the "Upgrading" page
+(http://xmlgraphics.apache.org/fop/stable/upgrading.html) for
+details.
+
+Major Changes in Version 0.93
+-----------------------------
+
+* Added support for the use of Open Type fonts (BD)
+* Support for the rgb-icc() function and for a proprietary cmyk()
+ function (for device CMYK colors only through the PDF renderer so
+ far). (JM) Thanks to Peter Coppens. Fixes 40729.
+* Enabled Copy/Paste from PDF content in Acrobat Reader for
+ text using embedded TrueType fonts. (BD) Thanks to Adam Strzelecki,
+ Victor Mote. Fixes 5535.
+* Added support for PDF/A-1b and PDF/X-3:2003. (Note: this may still
+ be a bit incomplete. Feedback is welcome!)
+* The Java2DRenderer (and therefore the print and bitmap renderers) is
+ now offering the same quality as the PDF and PS renderers. Note:
+ There can still be little differences between PDF and Print/PNG/TIFF
+ because the latter uses a different font metrics source.
+* Automatic support for all fonts available to the Java2D subsystem
+ for all Java2D-descendant renderers (TIFF, PNG, print, AWT).
+
+The long list of changes in this release is available at
+http://xmlgraphics.apache.org/fop/0.93/changes_0.93.html.
+
+The long list of changes in this and earlier releases is available at
+http://xmlgraphics.apache.org/fop/changes.html.
+
+The Apache FOP team asks you for your continued feedback on the
+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. ;-)
Release notes for older FOP versions can be found on:
http://xmlgraphics.apache.org/fop/relnotes.html
\ No newline at end of file
diff --git a/build.xml b/build.xml
index aead809dd..60d6537ae 100644
--- a/build.xml
+++ b/build.xml
@@ -101,8 +101,10 @@ list of possible build targets.
+
+
@@ -146,7 +148,7 @@ list of possible build targets.
-
+
diff --git a/fop.bat b/fop.bat
index 53674c034..c6d433b38 100644
--- a/fop.bat
+++ b/fop.bat
@@ -60,7 +60,7 @@ set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\xercesImpl-2.7.1.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\xalan-2.7.0.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\serializer-2.7.0.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\batik-all-1.6.jar
-set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\xmlgraphics-commons-1.1-snapshot.jar
+set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\xmlgraphics-commons-1.1.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\avalon-framework-4.2.0.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\commons-io-1.1.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\commons-logging-1.0.4.jar
diff --git a/forrest.properties b/forrest.properties
index f4fb7d9ca..537cb15e3 100644
--- a/forrest.properties
+++ b/forrest.properties
@@ -60,6 +60,7 @@ project.skin=pelt
#project.lib-dir=${project.content-dir}/lib
#project.classes-dir=${project.content-dir}/classes
#project.translations-dir=${project.content-dir}/translations
+project.knownissues=known-issues.xml
##############
# validation properties
diff --git a/known-issues.xml b/known-issues.xml
new file mode 100644
index 000000000..25af2a217
--- /dev/null
+++ b/known-issues.xml
@@ -0,0 +1,102 @@
+
+
+
+
+
+ MIF and SVG output support have not been restored, yet.
+
+
+ Java2D/AWT support has been improved, but some problems remain,
+ for example with block-containers.
+
+
+ Auto table layout is not implemented, yet.
+
+
+ The collapsing border model on tables is not implemented, yet. Please
+ use border-collapse="separate" for now.
+
+
+ Footnotes may overlap with text of the region-body in multi-column
+ documents.
+
+
+ Space resolution does not work between footnote regions.
+
+
+ There's a problem involving nested block-containers and
+ reference-orientation 180/-180 (Bugzilla #36391)
+
+
+ block-containers with no height currently don't create a fence for
+ spaces as they should (they behave like a normal block).
+
+
+ Preserved linefeeds in fo:character are not handled correctly.
+
+
+ An empty block currently produces a fence for stacking constraints
+ which it shouldn't.
+
+
+ There are several small problems around white space handling.
+
+
+ Images currently don't shrink so they fit on a page when they are
+ too big and shrinking is allowed to happen.
+
+
+ inline-container may not work as expected.
+
+
+ letter-spacing and word-spacing properties may not work as expected.
+
+
+ leaders with leader-pattern="use-content" may not work as expected.
+
+
+ keep-with-previous doesn't work inside tables and lists, yet.
+
+
+ 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.
+
+
+ background-images on page-number-citations are not placed correctly.
+
+
+ Not all FO elements can be referenced by their "id", most notably:
+ table-body, table-header, table-footer and table-row.
+
+
+ The backgrounds of table-body, table-header, table-footer and
+ table-column are not painted, yet.
+
+
+ Border and padding conditionality are not supported on table-cells, yet.
+
+
+ Column balancing in multi-column documents may not work as expected
+ (Bugzilla #36356)
+
+
+ Internal basic-links don't point to the exact location on a page, yet, as they
+ did in 0.20.5. Currently you land in the upper left corner of the page.
+
+
diff --git a/lib/xmlgraphics-commons-1.1-snapshot.jar b/lib/xmlgraphics-commons-1.1.jar
similarity index 91%
rename from lib/xmlgraphics-commons-1.1-snapshot.jar
rename to lib/xmlgraphics-commons-1.1.jar
index 48ae1e945fb2870537cb97f6f2ac1a4299a2907e..7fd9648b6af488a96ae0c85b13ba5901fbf3c0c9 100644
GIT binary patch
delta 14600
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
- FOP supports multiple output formats by using a different renderer for each format.
- The renderers do not all have the same set of capabilities, sometimes because of
- the output format itself, sometimes because some renderers get more development
- attention than others.
-
-
- General Information
-
- Fonts
-
- Most FOP renderers use a FOP-specific system for font registration.
- However, the Java2D/AWT and print renderers use the Java AWT package, which gets its
- font information from the operating system registration.
- This can result in several differences, including actually using different fonts,
- and having different font metrics for the same font.
- The net effect is that the layout of a given FO document can be quite different between
- renderers that do not use the same font information.
-
-
-
- Output to a Printer or Other Device
-
- The most obvious way to print your document is to use the FOP
- print renderer, which uses the Java2D API (AWT).
- However, you can also send output from the Postscript renderer directly to a Postscript
- device, or output from the PCL renderer directly to a PCL device.
-
-
- Here are Windows command-line examples for Postscript and PCL:
-
-
-
-
- Here is some Java code to accomplish the task in UNIX:
-
-
-
- Set the output MIME type to "application/x-pcl" (MimeConstants.MIME_PCL) and
- it happily sends the PCL to the UNIX printer queue.
-
-
-
-
- PDF
-
- PDF is the best supported output format. It is also the most accurate
- with text and layout. This creates a PDF document that is streamed out
- as each page is rendered. This means that the internal page index
- information is stored near the end of the document.
- The PDF version supported is 1.4. PDF versions are forwards/backwards
- compatible.
-
-
- Note that FOP does not currently support "tagged PDF", PDF/X or PDF/A-1a.
- Support for PDF/A-1b has recently been added, however.
-
-
- Fonts
-
- PDF has a set of fonts that are always available to all PDF viewers;
- to quote from the PDF Specification:
-
- "PDF prescribes a set of 14 standard fonts that can be used without prior
- definition.
- These include four faces each of three Latin text typefaces (Courier,
- Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf
- Dingbats). These fonts, or suitable substitute fonts with the same metrics, are
- guaranteed to be available in all PDF viewer applications."
-
-
-
- Post-processing
-
- FOP does not currently support several desirable PDF features: XMP metadata and watermarks.
- One workaround is to use Adobe Acrobat (the full version, not the Reader) to process
- the file manually or with scripting that it supports.
-
-
- Another popular post-processing tool is iText,
- which has tools for adding security features, document properties, watermarks, and many
- other features to PDF files.
-
-
- Caveat: iText may swallow PDF bookmarks. But
- Jens Stavnstrup tells us
- that this doesn't happen if you use iText's PDFStamper.
-
-
- Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now
- supports PDF encryption. However the principles for using
- iText for other PDF features are similar.)
-
-
-
- Check the iText tutorial and documentation for setting access flags, password,
- encryption strength and other parameters.
-
-
-
- Watermarks
-
- In addition to the PDF Post-processing options, consider the following workarounds:
-
-
-
- Use a background image for the body region.
-
-
- (submitted by Trevor Campbell) Place an image in a
- region that overlaps the flowing text. For example, make
- region-before large enough to contain your image. Then include a
- block (if necessary, use an absolutely positioned block-container)
- containing the watermark image in the static-content for the
- region-before. Note that the image will be drawn on top of the
- normal content.
-
-
-
-
-
- PostScript
-
- The PostScript renderer has been brought up to a similar quality as the
- PDF renderer, but may still be missing certain features. It provides good
- support for most text and layout.
- Images and SVG are not fully supported, yet. Currently, the PostScript
- renderer generates PostScript Level 3 with most DSC comments. Actually,
- the only Level 3 feature used is FlateDecode, everything else is Level 2.
-
-
- Limitations
-
-
Images and SVG may not be displayed correctly. SVG support is far from being complete. No image transparency is available.
-
Only Type 1 fonts are supported.
-
Multibyte characters are not supported.
-
PPD support is still missing.
-
-
-
-
- RTF
-
- JFOR, an open source XSL-FO to RTF converter has been integrated into Apache FOP.
- This will create an RTF (rich text format) document that will
- attempt to contain as much information from the fo document as
- possible. The RTF output follows Microsoft's RTF specifications
- and produces best results on Microsoft Word.
-
-
-
- XML (Area Tree XML)
-
- This is primarily for testing and verification. The XML created is simply
- a representation of the internal area tree put into XML. We use that to verify
- the functionality of FOP's layout engine.
-
-
- The other use case of the Area Tree XML is as FOP's "intermediate format". More information
- on that can be found on the page dedicated to the Intermediate Format.
-
-
-
- Java2D/AWT
- The Java2D/AWT, Print and Bitmap renderers may not yet fully work as expected. There are some known bugs and missing features.
-
- The AWT viewer shows a window with the pages displayed inside a
- Java graphic. It displays one page at a time.
- The fonts used for the formatting and viewing depend on the fonts
- available to your JRE.
-
-
-
- Print
-
- 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.
-
-
-
- Bitmap (TIFF/PNG)
-
- It is possible to directly create bitmap images from the individual
- pages generated by the layout engine.
- This is done with the same code that renders to the Java2D/AWT renderer.
-
-
- Currently, two output formats are supported: PNG and TIFF. TIFF produces
- one file with multiple pages, while PNG output produces one file per
- page. The quality of the bitmap depends on the resolution setting on the
- FOUserAgent.
-
-
-
- TXT
-
- The text renderer produces plain ASCII text output
- that attempts to match the output of the PDFRenderer as closely as
- possible. This was originally developed to accommodate an archive system
- that could only accept plain text files, and is primarily useful for getting
- a quick-and-dirty view of the document text. The renderer is very limited,
- so do not be surprised if it gives unsatisfactory results.
-
-
- The Text renderer works with a fixed size page buffer. The size of this
- buffer is controlled with the textCPI and textLPI public variables.
- The textCPI is the effective horizontal characters per inch to use.
- The textLPI is the vertical lines per inch to use. From these values
- and the page width and height the size of the buffer is calculated.
- The formatting objects to be rendered are then mapped to this grid.
- Graphic elements (lines, borders, etc) are assigned a lower priority
- than text, so text will overwrite any graphic element representations.
-
-
- Because FOP lays the text onto a grid during layout, there are frequently
- extra or missing spaces between characters and lines, which is generally
- unsatisfactory.
- Users have reported that the optimal settings to avoid such spacing problems are:
-
-
-
font-family="Courier"
-
font-size="7.3pt"
-
line-height="10.5pt"
-
-
-
- Output Formats in the Sandbox
-
- Due to the state of certain renderers we moved some of them to a "sandbox" area until
- they are ready for more serious use. The renderers and FOEventHandlers in the sandbox
- can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the
- main build. The output formats in the sandbox are marked as such below.
-
-
- PCL
- The PCL Renderer is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature.
-
- This format is for the Hewlett-Packard PCL printers.
- It should produce output as close to identical as possible to the
- printed output of the PDFRenderer within the limitations of the
- renderer, and output device.
-
-
-
-
-
-
- MIF
- The MIF handler is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature.
-
- This format is the Maker Interchange Format which is used by
- Adobe Framemaker.
-
-
-
- SVG
- The SVG renderer is in the sandbox and may not work as expected in FOP Trunk!!! Please help us improve this feature.
-
- This format creates an SVG document that has links between the pages.
- This is primarily for slides and creating svg images of pages.
- Large documents will create SVG files that are far too large for
- an SVG viewer to handle. Since FO documents usually have text the
- SVG document will have a large number of text elements.
- The font information for the text is obtained from the JVM in the
- same way as for the AWT viewer. If the SVG is viewed on a
- system where the fonts are different, such as another platform,
- then the page may look wrong.
-
-
-
-
- Wish list
-
- Apache FOP is easily extensible and allows you to add new output formats to enhance FOP's functionality. There's a number of output formats
- which are on our wish list. We're looking for volunteers to help us implement them.
-
-
-
- AFP (Advanced Function Presentation):
- The renderer has already been built and is in the process of being brought into the Apache FOP codebase.
-
-
-
-
-
-
diff --git a/src/documentation/content/xdocs/0.92/anttask.xml b/src/documentation/content/xdocs/0.93/anttask.xml
similarity index 87%
rename from src/documentation/content/xdocs/0.92/anttask.xml
rename to src/documentation/content/xdocs/0.93/anttask.xml
index 9831f2c01..44550c3d7 100644
--- a/src/documentation/content/xdocs/0.92/anttask.xml
+++ b/src/documentation/content/xdocs/0.93/anttask.xml
@@ -37,17 +37,19 @@
One method of defining the task is as follows:
diff --git a/src/documentation/content/xdocs/0.92/compiling.xml b/src/documentation/content/xdocs/0.93/compiling.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.92/compiling.xml
rename to src/documentation/content/xdocs/0.93/compiling.xml
diff --git a/src/documentation/content/xdocs/0.92/configuration.xml b/src/documentation/content/xdocs/0.93/configuration.xml
similarity index 86%
rename from src/documentation/content/xdocs/0.92/configuration.xml
rename to src/documentation/content/xdocs/0.93/configuration.xml
index 85cb8e25b..c40a64de5 100644
--- a/src/documentation/content/xdocs/0.92/configuration.xml
+++ b/src/documentation/content/xdocs/0.93/configuration.xml
@@ -221,6 +221,20 @@
]]>
+
+ Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC
+ color profile which indicates the target color space the PDF file is generated for. This
+ setting is mainly used in conjunction with the PDF/X feature.
+ An example:
+
+
Special Settings for the PostScript Renderer
@@ -246,6 +260,34 @@
]]>
+
+ Special Settings for the PCL Renderer
+
+ Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that
+ you don't have to do any custom font configuration in this case but you have to use the font names
+ offered by Java.
+
+
+ Additionally, there are certain settings that control who the renderer handles various elements.
+
+
+
+ The default value for the "rendering" setting is "speed" which causes borders
+ to be painted as plain rectangles. In this mode, no special borders (dotted,
+ dashed etc.) are available. If you want support for all border modes, set the
+ value to "quality" as indicated above. This will cause the borders to be painted
+ as bitmaps.
+
+
+ The default value for the "text-rendering" setting is "auto" which paints the
+ base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D.
+ If the mix of painting methods results in unwelcome output, you can set this
+ to "bitmap" which causes all text to be rendered as bitmaps.
+
+
diff --git a/src/documentation/content/xdocs/0.92/embedding.xml b/src/documentation/content/xdocs/0.93/embedding.xml
similarity index 100%
rename from src/documentation/content/xdocs/0.92/embedding.xml
rename to src/documentation/content/xdocs/0.93/embedding.xml
diff --git a/src/documentation/content/xdocs/0.92/extensions.xml b/src/documentation/content/xdocs/0.93/extensions.xml
similarity index 80%
rename from src/documentation/content/xdocs/0.92/extensions.xml
rename to src/documentation/content/xdocs/0.93/extensions.xml
index e2d19eca8..0c22ca123 100644
--- a/src/documentation/content/xdocs/0.92/extensions.xml
+++ b/src/documentation/content/xdocs/0.93/extensions.xml
@@ -51,8 +51,11 @@
http://xml.apache.org/fop/extensions to the root element:
- Currently, no extensions are implemented in FOP Trunk which use the FOP extension namespace.
+ xmlns:fox="http://xmlgraphics.apache.org/fop/extensions">]]>
+
+ Currently, no extension elements are implemented in FOP Trunk which use the
+ FOP extension namespace.
+ PDF Bookmarks
@@ -101,6 +104,21 @@ to following pages. Here is an example of FO code creating such a table-header:<
]]>
+
+ fox:orphan-content-limit and fox:widow-content-limit
+
+ 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.
+