Apache FOP: Known Issues

This page lists currently known issues in the FOP codebase.

Apache FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit tests during the normal build process. This indicates a problem in the current codebase. When a bug is fixed or a missing feature is added the entry for the relevant test case(s) are removed.

FO Tree

This section lists currently disabled test cases in the test suite for the FO tree tests. The data for this section comes from test/fotree/disabled-testcases.xml.

demo-test-failure.fo (demo test failure):
TODO: Add missing description in disabled-testcases.xml!

from-table-column_marker.fo (Markers and core function evaluation):
The code currently evaluates this function according to the column in which the marker appears in the source document, rather than the column it is retrieved in.

Layout Engine

This section lists currently disabled test cases in the test suite for the layout engine tests. The data for this section comes from test/layoutengine/disabled-testcases.xml.

basic-link_external-destination_2.xml (External link around an SVG not properly sized):
The bpd trait of the inlineparent area for the basic-link is not sized correctly if it wraps an image that is higher than the nominal line.

block-container_reference-orientation_bug36391.xml (Bugzilla #36391: reference-orientation):
There's a problem involving nested block-containers and reference-orientation 180/-180.
See also: http://issues.apache.org/bugzilla/show_bug.cgi?id=36391

block-container_space-before_space-after_3.xml (Auto-height block-containers produce fences):
Block-containers with no height currently don't create a fence for spaces as they should (they behave like a normal block).

block_font-stretch.xml (font-stretch NYI):
Font-stretch is not implemented, yet.

block_hyphenation_linefeed_preserve.xml (Hyphenation with preserved linefeeds):
When hyphenation is enabled and linefeeds are preserved linefeeds are painted as '#' and the text is output multiple times.

block_linefeed-treatment.xml (linefeed-treatment):
Preserved linefeeds in a fo:character are not handled correctly.

block_white-space-treatment_3.xml (white-space-treatment):
White space handling incorrectly stops at fo:inline boundaries when it comes to formatter generated line breaks.

block_space-before_space-after_8.xml (Empty blocks produce fences):
An empty block currently produces a fence for stacking constraints which it shouldn't.

block_white-space_nbsp_2.xml (block white-space nbsp 2):
The nbsp given as an fo:character is not adjustable and therefore the justification does not work in this case.

block_word-spacing.xml (block word-spacing):
Word-spacing may not work as expected.

block_word-spacing_text-align_justify.xml (block word-spacing text-align justify):
Word-spacing may not work as expected.

external-graphic_oversized.xml (external-graphic don't shrink):
Images currently don't shrink so they fit on a page when they are too big and shrinking is allowed to happen (min/opt/max).

external-graphic_src_uri.xml (Test case with HTTP URL):
Doesn't work behind a proxy which requires authorization.

footnote_space-resolution.xml (Space Resolution in foot note area):
Space resolution does not work between footnote regions.

footnote_in_inline.xml (Footnotes swallowed in hyphenated fo:inlines):
getChangedKnuthElements probably loses the footnote layout manager somewhere along the way.

footnote_in_list.xml (Footnotes swallowed in lists):
Element lists for lists are created by combining the element lists from list-item-label and list-item-body. The footnotes contained in the KnuthBlockBoxes are not propagated to the combined element list.
See also: http://issues.apache.org/bugzilla/show_bug.cgi?id=37579

footnote_in_table.xml (Footnotes swallowed in tables):
Element lists for tables are created by combining the element lists from the individual table-cells. The footnotes contained in the KnuthBlockBoxes are not propagated to the combined element list.
See also: http://issues.apache.org/bugzilla/show_bug.cgi?id=37579

inline_keep-together.xml (keeps on inlines NYI):
Keeps are not implemented in inline-level elements, yet.

inline_block_nested_3.xml (NPE for table inside an inline):
Placing a table as a child of an fo:inline produces a NullPointerException.

inline-container_block_nested.xml (inline-container is not implemented, yet.):
inline-container is not implemented, yet. Content of an inline-container will get swallowed. The test case contains no checks.

inline-container_border_padding.xml (inline-container is not implemented, yet.):
inline-container is not implemented, yet. Content of an inline-container will get swallowed.

inline_letter-spacing.xml (inline letter-spacing):
Letter-spacing may not work as expected within fo:inline.

inline_word-spacing.xml (inline word-spacing):
Word-spacing may not work as expected within fo:inline.

inline_word-spacing_text-align_justify.xml (inline word-spacing text-align justify):
TODO: Add missing description in disabled-testcases.xml!

leader-alignment.xml (leader-alignment NYI):
Leader-alignment is not yet implemented.

leader_leader-pattern_use-content_bug.xml (leader-pattern="use-content": Problem with line height):
Line height is not correctly calculated for use-content leaders whose height is larger than the rest of the line.
See also: http://www.nabble.com/leaders-with-leader-pattern%3D%22use-content%22-t546244.html

list-block_keep-with-previous.xml (keep-with-previous doesn't work in lists):
Keep-with-previous doesn't work inside tables and lists, yet.

list-item_block_keep-with-previous.xml (keep-with-previous doesn't work in lists):
Keep-with-previous doesn't work inside tables and lists, yet.

page-breaking_4.xml (Page breaking doesn't deal with IPD changes):
Page breaking currently doesn't support changing available IPD between pages of a single page-sequence. Element list generation has to be reset to redetermine line breaks in this case.

page-breaking_6.xml (Overflow handing is incomplete):
Line breaking is not 100% correct when there's too little space. Overflows are not detected and warned.

page-height_indefinite_simple.xml (Indefinite page height handling is imcomplete):
A RuntimeException is thrown for a page of indefinite height. Lots of warnings.

page-number-citation_background-image.xml (page-number-citation: Problem with background-image):
Background-images on page-number-citations are not placed correctly.

page-number-citation-last_basic.xml (page-number-citation-last: FOs spanning multiple pages are not properly handled.):
Resolution of forward references does not wait until an FO is fully finished when an FO spans multiple pages.

page-number-citation_complex_1.xml (IDs are not working on all FO elements):
The "id" attributes are not properly handled for all block-level FO elements.

page-number-citation_complex_2.xml (IDs are not working on all FO elements):
The "id" attributes are not properly handled for all inline-level FO elements.

region-body_column-count_footnote.xml (Footnotes in multi-column documents):
Footnotes may overlap with text of the region-body in multi-column documents.

region-body_column-count_balance_4col.xml (Column Balancing problems):
Situation in a 4-column document where the column balancing doesn't work and even causes some content to disappear.

region-body_column-count_bug36356.xml (Column Balancing problems):
Column balancing doesn't work as expected.

table-body_background-image.xml (No background-images on table-body):
The backgrounds of table-body, table-header, table-footer and table-column are not painted, yet.

table_border-collapse_collapse_1.xml (Collapsing Border Model NYI):
Border-collapse="collapse" is not yet implemented.

table_border-collapse_collapse_2.xml (Collapsing Border Model NYI):
Border-collapse="collapse" is not yet implemented.

table_border_padding.xml (Problems with border and padding on tables):
The element list seems to not be fully correct, yet, causing the layout to look odd.

table-cell_block_keep-with-previous.xml (keep-with-previous doesn't work inside tables):
Keep-with-previous doesn't work inside tables and lists, yet.

table-cell_border_padding_conditionality.xml (Border and padding conditionality is NYI on table-cells):
Border and padding conditionality are not supported on table-cells, yet.

table-header_background-image.xml (No background-images on table-header):
The backgrounds of table-body, table-header, table-footer and table-column are not painted, yet.

table-row_keep-with-previous.xml (keep-with-previous doesn't work on table-rows):
Keep-with-previous doesn't work inside tables and lists, yet.

table-cell_empty_area_with_marker.xml (table-cell empty area with marker.xml):
A table-cell producing an empty area does currently not add any markers to a page. See TODO entry in AreaAdditionUtil.

table_border-width_conditionality.xml (Border conditionality on table):
The code should be ok, but the test case uses shorthands and therefore is probably not expressing the indended outcome according to the spec. The test case should be revisited.

wrapper_block.xml (fo:wrapper around block-level content):
A ClassCastException occurs when fo:wrapper directly surrounds a block-level element because its layout manager is written to handle only inline content.

block_break-after_bug40230.xml (Bugzilla #40230: invalid extra page break):
Currently an extra page is created even if there is nothing after a block with break-after="page"
See also: http://issues.apache.org/bugzilla/show_bug.cgi?id=40230

Other known issues

This section lists other known issues.

• PCL, 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.