Notes

Quick-fix to avoid a possible NullPointerException when using empty inlines and hyphenation. Added missing generation of areas for empty grid units in tables with collapsing border model. Fixed memory leak in property cache (not cleaning stale PropertyCache$CacheEntry instances). Fixed text stroking in SVG when the stroke-width is zero. Fixed the source for a division by zero when the content of an fo:leader with leader-pattern="use-content" collapses to zero width during layout. Fixed border trait parsing for the area tree XML when CMYK or ICC colors were used. Fixed generation of "fonttbl" for RTF output to fix loading problem with AbiWord. Fixed ID resolution for nested bookmarks with duplicated IDs. Fixed a slight error when resolving non-file URLs: avoid altering the original 'href' if the protocol is other than 'file:' Added LayoutManagerMapping.registerMaker() to make registration of custom layout managers easier. Fixed absolute positioning of block-containers when specified using right and bottom instead of left and top. Added PDF encryption parameter support in configuration. Allowing non-zero borders and padding on page regions when relaxed validation is turned on. Fixed an inconsistency in footnote handling that led to unnecessary empty areas in pages whose last normal line contains footnotes when the page bpd is not the same for all pages. Changed FONode.addCharacters() parameter to closer match the signature of the standard SAX characters() event (reduces confusion and computations). !! Implementors of extensions that subclass FONode directly, and offer an implementation for addCharacters() should take care to make similar modifications in their code !! Added a PCL-specific extension attribute on simple-page-master for controlling the simplex/duplex mode. Corrected white-space-treatment for situations where an inline-node is the first/last child node of an fo:block, without preceding/following text. Implemented word-by-ford font-selection strategy on text. Support character-by-character font-selection strategy on fo:character element. Added support for page-number-citation and page-number-citation-last of fo:inline. Corrected behavior for page-number-citation-last of fo:block: forward references now properly resolved. For auto-detected fonts it is now possible to specify that a font needs to be referenced rather than embedded (for the output formats that support this distinction). Added support for the "id" attribute on fo:wrappers when used as a child of the fo:flow. Fixed a ClassCastException when using an fo:wrapper as a child of an fo:block-container. Add support for font substitution. PCL Renderer: Improved page format selection so it doesn't interfere with duplex printing. Fixed a regression introduced by the fix for Bugzilla 44286. Activated min-height/max-height and min-width/max-width properties. Fixed a logic error in Hyphenator.java: If the source had an associated InputStream, an UnsupportedOperationException was triggered. Add partial support for the "show-destination" property on fo:basic-link (PDF output only; see limitations on the compliance page) 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. Added support for rendering pages using JPS (Java Printing System). See new example: examples/embedding/java/ExamplesFO2JPSPrint.java Restored ability to specify from/to and odd/even pages as well as the number of copies for printing from the command-line. Added ability to pass a preconfigured PrinterJob instance to the PrintRenderer via the rendering options map. Added a public accessor for reference to the current page to PDFGraphics2D. Added support for auto-configuring TrueType Collections. XML font metrics files for *.ttc fonts are not required anymore. When a JPEG image is embedded, an optionally embedded color profile is filtered out as it's already embedded separately in the PDF file. Added support for addressing all glyphs available in a Type 1 font, not just the ones in the font's primary encoding.

Notes

Besides the important changes listed below, the most important areas with improvements in this release are:

Many bugfixes in tables, plus some new features (full support for keeps and breaks, border conditionality, background on columns and header/footer/body)
Improvements and bugfixes for font handling and font auto-detection/-registration.
Performance improvements and memory optimizations for the property handling in the FO tree.

Please note that with this release, we've dropped support for Java 1.3. FOP will, from now on, require at least Java 1.4.

There have been a few changes in tables that make FOP both more strict and more compliant to the Recommendation:

XSL-FO 1.1 explicitly states that a row-spanning fo:table-cell element is not allowed to span further than its enclosing fo:table-header/footer/body element (see bottom of section 6.7.3). From now on FOP will give a validation error if a document contains such an erroneous cell.
If an fo:table element contains explicit fo:table-column children, then those elements set the total number of columns in the table. This means that a validation error will now occur if a row contains more cells than available columns. This change allows to improve performance, since the rendering of the table may start as soon as the table-column elements have been parsed.

If more flexibility is needed, then the fo:table-column elements may be just omitted. The final number of columns will then be set by the row that has the most cells.

The image libraries Jimi and JAI are no longer needed (and used) for image loading. Instead we rely completely on the Image I/O API that has been introduced with Java 1.4. If you still need support for bitmap image formats that do not work out-of-the-box, we recommend adding JAI Image I/O Tools (an Image I/O compatible image codec package) to the classpath. JAI is still required for building the FOP distribution but it is optional for normal builds and at run-time.

This final 0.95 release also includes all of the changes made for Apache FOP 0.95beta.

Fixed a color selection problem which occurred after an image has been painted through the Graphics2DAdapter in PDF output. Fixed page ordering problem with AWTRenderer. Fixed image scaling for RTF output. Fixed the -imagein command-line option. Added support for fo:leader for RTF output (no full support!). Fixes problems with empty leaders being used to force empty lines among other issues. Added support for page-number-citation for RTF output. Fixed handling of proportional-column-width() and percentages for table column in RTF output. Fixed NullPointerException when page-number-citations are used inside a marker. Fixed two bugs concerning resolution handling with SVG images and their conversion to bitmaps for RTF output. Fixed potential multi-threading problem concerning the use of DecimalFormat. Regression bugfix: Multiple collapsible breaks don't cause empty pages anymore. Fixed resolution handling inside AWT preview dialog. Fixed positioning of absolutely positioned block-containers in multi-column documents. Fixed rendering of fixed block-containers in AFP output. Various bugfixes for table layout. Fixed regression causing bad positioning of block-containers if used as descendant of a table-cell. Fixed text extraction problem with ZapfDingbats and Symbol font in PDF output. Fixed a performance problem concerning image serialization. Fixed NullPointerException when loading a TrueType font using XML font metric files.

Notes

Besides the important changes listed below, the most important areas with improvements in this release are:

Many bugfixes in tables, plus some new features (full support for keeps and breaks, border conditionality, background on columns and header/footer/body)
Improvements and bugfixes for font handling and font auto-detection/-registration.
Performance improvements and memory optimizations for the property handling in the FO tree.

Please note that with this release, we've dropped support for Java 1.3. FOP will, from now on, require at least Java 1.4.

There have been a few changes in tables that make FOP both more strict and more compliant to the Recommendation:

XSL-FO 1.1 explicitly states that a row-spanning fo:table-cell element is not allowed to span further than its enclosing fo:table-header/footer/body element (see bottom of section 6.7.3). From now on FOP will give a validation error if a document contains such an erroneous cell.
If an fo:table element contains explicit fo:table-column children, then those elements set the total number of columns in the table. This means that a validation error will now occur if a row contains more cells than available columns. This change allows to improve performance, since the rendering of the table may start as soon as the table-column elements have been parsed.

If more flexibility is needed, then the fo:table-column elements may be just omitted. The final number of columns will then be set by the row that has the most cells.

Bugfix: The before border of a block is no longer swallowed if its first child issues a break-before. Bugfix: When there was a forced break after a block with (conditional) borders the border-after wasn't painted. Bugfix: a forced break inside a cell was ignored when occurring before the minimum height set on the enclosing row was set. Fixed exceptions when lists, tables or block-container are children of an inline-level FO. Added support for background on fo:table-column and fo:table-header/footer/body elements. Fixed the rendering of the area of a table corresponding to border-separation, which must be filled with the background of the table, and not the rows. Improved conformance: even if a table-cell spans several rows its background must correspond to the first row spanned. Slight improvement for thin lines in Java2D/AWT output. Added full support for keep-with-previous on fo:table-row and in fo:table-cell elements. Turned on XInclude processing for the main source given on the command line. Improved the font auto-detection so fonts accessed using the font-family name are selected with higher accuracy. Removed deprecated methods in the "apps" package that were left-overs from the API discussions. Added support for unusual font encodings (like for Symbol or Cyrillic fonts) of Type 1 fonts in PDF and PostScript output. Moved to the FO tree stage the check for break-before/after on table-row while spanning in progress. Added full support for breaks before and after table cells (that is, break-before/after set on the first/last child of a cell). Added full support for breaks inside the cells of a table. Added correct percentage resolution for arguments to the proportional-column-width() function. Bugfix for date formatting with negative time zones in the PDF's Info object. This affected PDF/A compliance. Added an option to disable the default sRGB profile in PDF output for those who don't care about color fidelity, but care about PDF file size. Fixed a bug when the rgb-icc() function was used either before the fo:declarations, or in documents without a fo:declarations node. In such cases, the sRGB fallback is now used to avoid an ugly NullPointerException. Added very basic parsing for the xml:lang shorthand. Fixed a bug when using relative font-size (smaller/larger) in combination with percentages. Bugfix for handling of optional tables in subset TrueType fonts. This bug caused errors in various PDF viewers. Added support for the natural language indentifier ("Lang" in the document catalog) for PDF documents based on the language/country values on fo:page-sequence. Fixed a memory-leak in XMLWhiteSpaceHandler. Fixed the resolution of borders when header/footer is omitted at page breaks. Added support for conditional borders in tables, for both the separate and the collapsing border model. Fixed a possible IndexOutOfBoundsException that could happen with certain constellations when footnotes are used. Compliance fix: for absolutely positioned block-containers, "top" wasn't interpreted correctly. New extension attribute fox:transform on fo:block-container allows free-form transformation (rotation, scaling etc.) of absolute and fixed block-containers. Supported only for PDF, PS and Java2D-based renderers. Fixed logic error setting the transformation matrix for block-container viewports (applies to absolute and fixed block-containers only). Important: External renderer implementations need to adjust for the change and implement the new method concatenateTransformationMatrix(AffineTransform) if the renderer is derived from AbstractPathOrientedRenderer. A new image loading framework has been introduced to fix various problems with external graphics and improve performance. Fixed generation of named destinations so it works when the PDF document is encrypted. PostScript output now generates the bounding box DSC comments for the whole document. Added support for PDF page labels. Added support for custom fonts in Java2DRenderer and derived renderers. Added new extension element: fox:external-document. It allows to add whole documents such as multi-page TIFF images to be inserted as peers to a page-sequence. Each image will make up an entire page. See the documentation for details. Added minimal support for the .minimum/.maximum components of block/inline-progression-dimension on fo:external-graphic and fo:instream-foreign-object. Added support for scale-down-to-fit and scale-up-to-fit (introduced in XSL 1.1). Bugfix: content of a row with zero height overriding the previous row Bugfix: allow multiple bookmarks to point at the same destination. Bugfix for border-after painting and element list generation when a forced break is involved. Bugfix: no empty page is generated anymore if there's no content after a break-after. Restored proper handling of fo:table-cell having no children, which is allowed in relaxed validation mode. Memory Leak fixed in the Property Cache. Fixed by Jeremias Maerki. Reported and Tested By Chris Bowditch. Bugfix in tables: wrong element generation by the merging algorithm when glues must be produced to cope with conditional spaces. The corresponding length was added twice: one in the glue itself and one in the following box. Bugfix for URI resolution: Make StreamSources without system identifier work again. Avoid a NullPointerException in AreaTreeHandler.endDocument(). Bugfix: breaks generated by the merging algorithm for a table-row containing empty cells had always a penalty of 900. Added methods for fo:page-number-citation(-last) in FOEventHandler. Step towards performance: the collapsing-border resolution algorithm no longer triggers the retrieving of the whole table, when possible. In case of missing cells the border-end of the table was applied to an inner cell, instead of the (empty) cell in the last column. Fixed the resolution of borders with table-columns (border-before/after was wrongly applied to every cell of the column). Fixed the resolution of border-end on cells spanning several rows. Bugfix: Use Font.getName() (logical font name) instead of Font.getFontName() (localized) when registering fonts from AWT. Made the way TrueType fonts are embedded in PDF compliant to the specification so viewers correctly identify subset fonts. Fixed font-autodetection so fonts with uppercase extensions are detected, too. Improved font auto-detection and handling of AWT-supplied fonts in order to achieve better results when using multiple output formats. Whenever possible, the font names appearing in the operating system can also be used in XSL-FO. Fixed regression: transparent-page-background was not recognized for PNG output. Added check for table-cells which span more rows than available in their parent element (table-header/footer/body). Added support for fo:markers in fo:inline and fo:basic-link. PDF Transcoder (SVG) text painting has been completely rewritten. Except for some special cases (with filters for example), all text (including flow text) is now painted using PDF text operators. Added support for ids on empty fo:inlines. Add Font support in jar files. Postscript extension cleanup. Fix to avoid ClassCastException where multiple ps:ps-comments are declared within fo:declarations. Fix to avoid NullPointerException when parsing ExpertEncoded and ExpertSubsetEncoded Type 1 fonts. Fixes missing TLE value attribute when using AreaTree input with the AFP renderer. Added generic structures to the PDF library in order to support PDF file in fo:external-graphic later. Added support for SVGZ. Bugfix for NPE with empty table-row (regression from 0.93). Added a configuration setting to the PCL renderer to disable PJL commands. Fix to avoid a ClassCastException in renderer configuration. Fixed the restoration of the TLE values from the intermediate format for the AFP extension elements. Added a configuration setting for the renderer/device resolution to the AFP renderer. Facilitate the implementation for font-selection-strategy:
• Changed FontInfo.fontLookup to always return an array of FontTriplet.
• Changed CommonFont.getFontState to return an array of FontTriplet.
• Initial modifications to the related LMs: initialized with the font corresponding to the first of the triplets.
PropertyCache phase 2:
• improvement of the PropertyCache itself should now guarantee acceptable performance of the static caches in multi-session environments, which is a possible problem with synchronizedMap.
• changed CommonFont to use the cache: added CachedCommonFont to contain the properties that are always cacheable CommonFont itself is only cached if the remaining properties are absolutes.
• changed CommonHyphenation, KeepProperty, ColorProperty and FontFamilyProperty to use the cache.
Fixed swallowing PCDATA in text-node children of retrieved markers. Fixed erroneous white-space removal in retrieved markers. Fixed erroneous usage of inherited color-values in SVG. AFP Renderer: Bugfix for 1 bit images where the width is not a multiple of 8. Support for keep-together.within-line="always". Fixed incomplete support for Unicode Word Joiner characters (U+2060 and U+FEFF). Add support for conditional spaces in table-cells. Support alignment-adjust for images. Partial application of the patch in Bugzilla 41044: * addition of a generic PropertyCache to be used by all Property types that can be safely canonicalized * modified EnumProperty, StringProperty, NumberProperty, EnumNumber and FixedLength to make use of the cache infrastructure Refactoring in the fo package: -> removal of the childNodes instance member in fop.fo.FObj -> addition of a firstChild instance member in fop.fo.FObj -> addition of a siblings instance member in fop.fo.FONode -> addition of a FONodeIterator interface in FONode + corresponding implementation in FObj -> changed implementations of FObj.addChildNode(), .removeChild() and .getChildNodes() Code cleanup and restructuring: Refactoring of PageSequenceLayoutManager and provide common FObj id property use Slight improvement of relative font-weight handling in the properties package. Updated PDF/A-1b support according to ISO-19005-1:2005/Cor.1:2007. Add support for font auto-detection (easier font configuration). Use source resolution setting for bitmap images which don't provide their own resolution. Fixed the rendering of zero-width spaces for certain fonts by not generating them into the area tree. Fixed a problem with disappearing footnotes inside hyphenated inlines (and footnotes with hyphenated inline child). Add support for exact positioning of internal PDF links. Fix PDF Genaration for non-ASCII compatible locales. Fix several exceptions when break-before/after is set on the first/last row of a table. Fix extra page break when break-before is set on both a table and its first row. Make keep-with-next and keep-with-previous work on fo:table. Add support for the collapsing-border model in tables. Add support for named destinations in PDF. Fixed a problem with keep-with-next on table-rows. Once a keep-with-next was set inside a table, the FO following the table would always be glued to the previous table. Fixed a problem with the auto-rotate-landscape setting in the PostScript renderer. It didn't generate the right setpagedevice command. Fixed an IllegalArgumentException for absolutely positioned block-containers with a border and no height/bpd set. Add support for a two-pass production for PostScript output to minimize file size. This adds images only once and adds only the fonts that are really used. If a line contained nothing but a linefeed, this didn't produce empty lines. Replaced the auxiliary zero-width box with a glue the width of a line, and shrinkable to zero-width. Stricter FOP user configuration checking Fix parsing 'url(...)' when the URL itself contains a bracketed part. Support for GIF images in RTF output (RTF handler, only. Does not affect the RTF library.) Fix for NPE with PNG images for RTF output. Fix for properly parsing font-family names containing spaces. Support for soft masks (transparency) with ImageIO image adapter. Fix incorrect behaviour of the BreakingAlgorithm when some inline content is wider than the available ipd, causing a restart. Fix for PDF corruption when a TrueType font with spaces in its name is embedded and no XML font metrics file for that font is used. Fix for ClassCastException when fo:wrapper was used as direct child of fo:flow. Note: "id" attributes are still not handled properly on fo:wrapper! Added support for the soft hyphen (SHY) character. Added support for line-height-shift-adjustment property. Added support for the system property fop.home to cli.Main.getJARList(). Added support for display-align for table-cell in RTF output. Added support for UAX#14 type line breaking. Support does not extend across nested fo:inline elements.

Notes

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.
See the compliance page for an overview of the compliance of this release with the XSL 1.0 and 1.1 recommendations.
This release again contains many bug fixes and new features. See below for details.
See the known issues page for an overview of the known issues with this release.

Caveats:

You may experience different behaviour compared to version 0.20.5. Please consult the "Upgrading" page for details.

Added support for the use of Open Type fonts Enabled Copy/Paste from PDF content in Acrobat Reader for text using embedded TrueType fonts. Commented out unused properties, in order to minimize memory usage. Removed unused attributes from TableCell. Added initial support for loading fonts without a pre-created XML font metric file. Support for the rgb-icc() function and for a proprietary cmyk() function (for device CMYK colors only through the PDF renderer so far). Minor fixes and improvements for the AWT Preview (keyboard shortcuts, scrolling, windows setup). Added support for SVG in fo:instream-foreign objects for RTF output. Bugfix: Fixed bug when the sum of column widths of a table is larger than the specified widths. The table width was not adjusted. Bugfix: Nested tables with headers and footers were not handled correctly and could overlap with the region-after. Added support for CCITT compression in the TIFFRenderer by switching to the ImageWriter abstraction from XML Graphics Commons. Extension properties fox:orphan-content-limit and fox:widow-content-limit which help with list-block and table layout. See the documentation for details. Configuration option in the Java2D-based renderers that allows to disable the default white background in order to produce bitmap output with transparency. Split up FOText instances larger than 32K characters to avoid integer overflow during layout. Bugfix: Corrected painting of shading patterns and position of links for SVG images inside FO documents. Minor fix: correctly set negative values for ipd/bpd to zero. Rework of default column-creation / column-width setting from cells in the first row. Added relaxed validation for empty list-item-*, as suggested by Gary Reed. Modified proportional-column-width() function to log an error if used with table-layout=auto Deferred property resolution for markers until they are actually retrieved, which leads to percentages and relative font-sizes now getting the correct values. Also deferred white-space-handling for markers. Changed the way overflowing pages are handled. The overflow property on region-body is now used to define the behaviour. Fixed a memory-leak: The FO tree part of a page-sequence was not released when a page-sequence was finished. Bugfix: Table headers and footers were swallowed when a table was nested in a list-block. Fixed a bug with indent handling when margins are used on a surrounding block and not start/end-indent. Compatibility fix for GCJ (GNU Classpath): Using "UTF-16BE" instead of "UnicodeBigUnmarked" encoding. Fixed handling for CCITT Group 4 TIFF images with fill order 2. Fixed setting of page margins in AWT Renderer like it was done in the print renderer. Fixed two memory-leaks in image handling. The image cache is finally working properly. Let numeric property values without a unit be treated as pixels like in HTML. This fixes certain NullPointerException when no units are specified. (Note: the use of pixels in XSL-FO is discouraged!) Bugfix: Potential multi-threading issue (ConcurrentModificationException) eliminated for ElementMapping classes. No more System.exit() and look & feel setting calls inside the reusable parts of the AWT viewer. Proper escaping of characters in list-items labels for RTF output. Bugfix: FOUserAgent specific configuration parameters specified in config file were not set when FOP was invoked from command line. Added support for PDF/A-1b and PDF/X-3:2003. (Note: this may still be a bit incomplete. Feedback is welcome!) The CIDSet object is now generated for CID fonts which are embedded in PDFs. (Required by PDF/A). 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. Bugfix: components of the border-separation property weren't set when in shorthand-mode, leading to a NPE being thrown. Bugfix: Table headers were omitted when a table is a child of a block-container. Bugfix: Bookmarks in PDF will be generated even if some bookmarks cannot be resolved. Bugfix: the interaction between the table FOs and properties package in determining initial values for column-number should be a one-time process, not repeated when the table is in a marker that is retrieved. Bugfix: All fonts names were converted unnecessarily to lower case in RTF output. Bugfix: The combination of hyphenation and kerning resulted in slightly ragged right ends for right-aligned and justified text. Bugfix: NullPointerException in AreaAdditionUtil in a table-cell spanning multiple pages and with a marker. Bugfix: NullPointerException in RTF output when a table does not contain table-columns. Bugfix: NullPointerException in RTF library when there are no borders on the parent table. Automatic support for all fonts available to the Java2D subsystem for all Java2D-descendant renderers (TIFF, PNG, print, AWT). Bugfix: Improved baseline detection in TTFReader for TrueType fonts. Bugfix: tables nested in inline elements caused a NullPointerException. The default sRGB color profile provided by the Java class library is no longer embedded if it is encountered. This should reduce the PDF size considerably. Bugfix: Sections with span="all" lead to overlapping text if spanning multiple pages. Bugfix: Percentages in vertical-align property values were not correctly handled. Bugfix: Gaps in table-columns cause a NullPointerException. Changed the internal representation of colors to use Java's own color infrastructure instead of FOP's home-grown classes. Bugfix: TABs were not correctly replaced by spaces in some circumstances. Content in block-containers makes better use of shrink to fit content vertically into the available area. This can be used indirectly to justify content vertically in a block-container. Bugfix: basic-links with internal destinations in documents with multiple page-sequences sometimes pointed at the wrong page. Bugfix: Fixed ClassCastException when retrieve-marker is used as a direct child if static-content in which case leading and trailing white space is not properly removed. Bugfix: Fixed OutOfMemoryException with long data URLs (RFC 2397). Initial support for page-number-citation-last (XSL 1.1). Works without problems only for page-sequence so far. Bugfix: The generation of the PDF "d" (setdash) command was assuming that only integer values can be used but that isn't the case. Dash patterns PDFGraphics2D would be wrong in the process. Bugfix: Fixed a division by zero problem in TTFReader and improved the detection of the capHeight and xHeight font metric values for TrueType fonts. Bugfix: Allow URLs in basic-link's external-destination to be wrapped in "url()". Bugfix: Corrected enumerated property value for white-space property from "no-wrap" to "nowrap". Bugfix: Added support for white-space-treatment="preserve" in particular to support the white-space="pre" short hand property. Corrected expectation and behaviour for the text-indent property to only apply to the first line area generated by a block. Bugfix for invalid handling of ICC color profiles in JPEG images and for dealing with CMYK JPEG images with the Adobe APPE marker. Initial support for page-position="last" added. Reenabled loading of user-supplied hyphenation patterns that was available in FOP 0.20.5. (See "hyphenation-base" option in the user configuration) Bugfix: Certain filter combinations in PDF could lead to invalid PDFs. DecodeParams were not properly handled. Bugfix: CCITT Group 4 encoded TIFF images with multiple strips are now properly embedded in PDF files. Added support for fixed-width spaces. Added support for kerning. Bugfix: Fixed a copy/paste error in the table layout code that caused wrong page break decisions when table-headers and/or table-footers are used. Bugfix: Fixed an NPE that was thrown when a table was used inside a footnote-body. Bugfix: Fixed a problem with certain TrueType fonts which are missing the "PCLT" table, where a baseline-shift="sub" had no effect due to a missing x-height value. (Note: This only affects TTFReader, so the font metric file has to be regenerated.) Bugfix: When the base URL was specified as a file system path, the constructed URL was wrong. Support for "userconfig" attribute in FOP Ant Task. Initial support for XMP metadata (PDF 1.4) under fo:declarations. Added support for the background-position shorthand property. Added support for the font shorthand property. Added support for system-color() function. Bugfix: Fixed two causes for ClassCastExceptions in BlockContainerLayoutManager. Bugfix: padding-top and padding-bottom on list-items could lead to wrong page break decisions and thus to overlapping text. Bugfix: break-before and break-after were ignored on list-items. Bugfix: The elements representing a non-breaking space weren't always correct. Bugfix: Text-decoration was not promoted if no text-decoration attribute was specified on a nested element. Added support for the from-table-column() function. Bugfix: Spanned cells could lead to an false error message about overlapping cells and ultimately a NullPointerException. Bugfix: Regions with non-standard names got ignored in RTF output leading to missing headers and footers. The RTF output now properly generates the "\landscape" flag for documents in landscape orientation. Following a clarification by the XSL FO SG, space traits are only set on the first and last area generated by an FO, and not on every area anymore. New feature: "Intermediate format" (IF). The IF is basically the XML dialect written by the area tree renderer (XMLRenderer). A new parser for this format allows reparsing a serialized and possibly modified area tree and rendering it to the final target format. Bugfix: Floating point numbers were not properly formatted in the PDF renderer which could lead to error messages while opening a PDF in Acrobat Reader. Implement property name as default argument on some xsl-function calls. Implement force-page-count property of page-sequence. Bugfix: Spans that end up with a negative height don't get swallowed anymore. Relative URLs for the font configuration attributes metrics-url and embed-url are now supported. A new configuration property font-base has been added. It sets the base URL against which relative font URLs are resolved. If font-base is not set base is used. Added support for RFC2397 "data" URLs. Bugfix: Certain border styles could lead to a NullPointerException. Bugfix: Space was not adjusted if the space was on a nested block. This could lead to content overflowing the bottom of a page. Bugfix: TableCell did not properly report that it generates reference-areas which could lead to wrong inherited values for start-indent and end-indent. The font loading code now reads the encoding value from the XML font metrics file so that fonts like Symbol and ZapfDingbats can be embedded explicitely (Required by PDF/A). Improvements to the code for inline block content. Bugfix: Image height for BMP images was incorrectly calculated Revision of refinement white-space handling. Added feature: support for white-space shorthand Added feature: support for page-break-* shorthands Bugfix: NullPointerException on certain fo:inline within lists. Bugfix: ClassCastException on certain fo:inline with border combinations. Changed a method name in LineArea from finalize to finalise because it was never intended for the method to be an override of the Java Object finalize method. If invoked by the Java garbage collector it may cause a NPE. Deprecated Fop constructors that use integer constants to select the output format have been removed in favor or the constructors that use MIME types. Fixed a bug where the linefeed-treatment property value "preserve" was not honoured when used in conjunction with text-align="center". Bugfix: hard breaks with even-page or odd-page were not handled correctly when spaces were surrounding the break. Changed the XMLHandler interface so it doesn't report the MIME type it supports but instead can report whether it supports a particular Renderer implementation. XMLHandlers are now configurable. Fixed a bug where SVG content could be clipped when rendered to PostScript. Changed the way resolutions are handled. The single resolution in the user agent got split up into source and target resolutions. For more info, see the updated documentation. Note: backwards-incompatible change! Bugfix: Some content inside a table-header may not have been renderered on pages n > 1 in certain conditions. Fixed a bug where an empty line, i.e. a block containing only a  , was not rendered at all. Fixed a bug where the area for a finished cell that is broken over pages was created once for each row it was spanned over instead of only once. Added checks that warn about tables and block-containers that are wider than the available content area. Bugfix: Footnotes were lost if the footnote appeared in centered text. Improved log and error messages in a number of places by adding additional context information that should make it easier to find the location in the source files. Fix to correct image sizes in RTF output. First attempt at SVG support in RTF output. SVG images are converted to 300dpi JPEG images internally. Additional checks to detect text overflows. The overflow property is now properly handled where applicable. Source location information improved. If location information is not available, the context information is provided based on text content. The command-line now automatically sets two parameters for any XSLT transformation: "fop-output-format" contains the MIME type of the currently selected output format, "fop-version" contains FOP's version number. The output file is now deleted when an exception occurs when calling FOP from the command-line. Bugfix: Areas for table-cells that are broken over more than one page are now generated even if all its content is already painted on a previous page. This fixes strange effects like a table grid that is not completely painted. Bugfix: Column balancing produced strange break decisions in certain multi-column documents with large amounts of text. Added an alternative set of rules for calculating text indents which tries to mimic the behaviour of many commercial FO implementations that chose to break the rules in the FO specification in order to better meet the natural expectations of inexperienced FO users. Bugfix: The combination of content-width="scale-to-fit" and content-height="100%" did not work as expected due to a datatype conversion bug. Bugfix: A span="all" on the first block cause a subsequent page break and the first block didn't span all columns. Bugfix: Self-created OutputStreams in PNG Renderer were not properly closed. The border-collapse property on fo:table is now forced to the value "separate" until the collapsing border has been implemented. font-family list still not fully supported but a comma-separated list is now properly tokenized. FOP will now go through all fonts in the list to find one that is available, but it doesn't do so per character, yet. Implemented "Overconstrained Geometry" rules (5.3.4, XSL 1.0) for the most important cases. Bugfix: Relatively positioned BlockViewports (from block-containers) caused the paint cursor not be be properly advanced when space-before or space-after were present. Bugfix: Space resolution was incomplete for content in table-cells. Conditional elements didn't get removed. The validation check for non-zero borders and padding on a region-* and for empty static-content elements is now turned off when relaxed validation is active to improve compatibility with FO documents written for other FO implementations. Bugfix for "/ by zero" ArithmeticExceptions when an URL to a non-existing image is used and content-width and/or content-height is used. Bugfix for a multi-threading problem: propertyListTable initialization moved from the constructor to a static block in FONode. This fixes NullPointerExceptions in PropertyList. Bugfix for placement of text inside a text area when borders are present in PostScript output. Improvements on leader painting in PDF output. Support for leader painting in PostScript output. Support for hyphenation-ladder-count. Complete redesign of the FOP codebase in the period between Dec 2001 and Nov 2005. There are just too many changes to list here. If you like to know details, run "svn log --verbose http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/". For the change log for the maintenance branch (where FOP 0.20.5 came from), please see the "CHANGES" file in the distribution, or the CHANGES file in the SVN repository. Improve the documentation.