Added descriptions to disabled-testcases (by Manuel Mall). Corrected and commented...

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@345569 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/test/layoutengine/disabled-testcases.dtd b/test/layoutengine/disabled-testcases.dtd
index 3433625488e90c1cfc8af92be717daa7574fc4ac..f9919816926ca11cb5329c5061b321f93a5dc556 100755 (executable)
--- a/test/layoutengine/disabled-testcases.dtd
+++ b/test/layoutengine/disabled-testcases.dtd
@@ -1,7 +1,11 @@
 <!ELEMENT disabled-testcases (testcase)*>\r
 <!ELEMENT testcase (name?,file,description?,reference*)>\r
-<!ATTLIST testcase id ID>\r
-<!ELEMENT name #PCDATA>\r
-<!ELEMENT file #PCDATA>\r
-<!ELEMENT description #PCDATA>\r
-<!ELEMENT reference #PCDATA>
\ No newline at end of file
+<!ATTLIST testcase id ID #IMPLIED>\r
+<!-- Testcase name. Can be used as title in a webpage. -->\r
+<!ELEMENT name (#PCDATA)>\r
+<!-- Testcase file. Used for filtering file names, obviously. -->\r
+<!ELEMENT file (#PCDATA)>\r
+<!-- Testcase description. Either text, one paragraph, or HTML markup (block level). -->\r
+<!ELEMENT description ANY>\r
+<!-- A single reference. Should be an URL. -->\r
+<!ELEMENT reference (#PCDATA)>
\ No newline at end of file

diff --git a/test/layoutengine/disabled-testcases.xml b/test/layoutengine/disabled-testcases.xml
index e22c8516e9b99c438d9ecaf9c5c67c5bee9556d0..b1debef39b71ce4d19f3485e137535489c66450c 100755 (executable)
--- a/test/layoutengine/disabled-testcases.xml
+++ b/test/layoutengine/disabled-testcases.xml
@@ -1,105 +1,122 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE disabled-testcases SYSTEM "disabled-testcases.dtd">
 <disabled-testcases>
   <testcase>
     <name>block-container reference-orientation bug36391</name>
     <file>block-container_reference-orientation_bug36391.xml</file>
-    <description></description>
+    <description>There's a problem involving nested block-containers
+    and reference-orientation 180/-180.</description>
     <reference>http://issues.apache.org/bugzilla/show_bug.cgi?id=36391</reference>
   </testcase>
   <testcase>
     <name>block-container space-before space-after_3</name>
     <file>block-container_space-before_space-after_3.xml</file>
-    <description></description>
+    <description>Block-containers with no height currently don't
+    create a fence for spaces as they should (they behave like a
+    normal block).</description>
   </testcase>
   <testcase>
     <name>block font-stretch</name>
     <file>block_font-stretch.xml</file>
-    <description></description>
+    <description>Font-stretch is not implemented, yet.</description>
   </testcase>
   <testcase>
     <name>block linefeed-treatment</name>
     <file>block_linefeed-treatment.xml</file>
-    <description></description>
+    <description>Preserved linefeeds in a fo:character are not handled
+    correctly. Zero width space characters are not handled
+    correctly.</description>
   </testcase>
   <testcase>
     <name>block padding 2</name>
     <file>block_padding_2.xml</file>
-    <description></description>
   </testcase>
   <testcase>
     <name>block space-before space-after 8</name>
     <file>block_space-before_space-after_8.xml</file>
-    <description></description>
+    <description>An empty block currently produces a fence for
+    stacking constraints which it shouldn't.</description>
   </testcase>
   <testcase>
     <name>block white-space-collapse 2</name>
     <file>block_white-space-collapse_2.xml</file>
-    <description></description>
   </testcase>
   <testcase>
     <name>block white-space-treatment 1</name>
     <file>block_white-space-treatment_1.xml</file>
-    <description></description>
+    <description>White space around formatter generated linebreaks is
+    not removed correctly.</description>
   </testcase>
   <testcase>
     <name>block white-space-treatment 2</name>
     <file>block_white-space-treatment_2.xml</file>
-    <description></description>
+    <description>White space around formatter generated linebreaks is
+    not removed correctly.</description>
   </testcase>
   <testcase>
     <name>block word-spacing</name>
     <file>block_word-spacing.xml</file>
-    <description></description>
+    <description>Word-spacing may not work as expected.</description>
   </testcase>
   <testcase>
     <name>block word-spacing text-align justify</name>
     <file>block_word-spacing_text-align_justify.xml</file>
-    <description></description>
+    <description>Word-spacing may not work as expected.</description>
   </testcase>
   <testcase>
     <name>external-graphic oversized</name>
     <file>external-graphic_oversized.xml</file>
-    <description></description>
+    <description>Images currently don't shrink so they fit on a page
+    when they are too big and shrinking is allowed to
+    happen.</description>
   </testcase>
   <testcase>
     <name>external-graphic src uri</name>
     <file>external-graphic_src_uri.xml</file>
-    <description>Doesn't work behind a proxy requiring authorization.</description>
+    <description>Doesn't work behind a proxy which requires
+    authorization.</description>
   </testcase>
   <testcase>
     <name>footnote space-resolution</name>
     <file>footnote_space-resolution.xml</file>
-    <description></description>
+    <description>Space resolution does not work between footnote
+    regions.</description>
   </testcase>
   <testcase>
     <name>inline block keep-together</name>
     <file>inline-block_keep-together.xml</file>
-    <description></description>
+    <description>Block-level content in fo:inlines may produce
+    unwelcome results.</description>
   </testcase>
   <testcase>
     <name>inline block nested 3</name>
     <file>inline_block_nested_3.xml</file>
-    <description></description>
+    <description>Block-level content in fo:inlines may produce
+    unwelcome results.</description>
   </testcase>
   <testcase>
     <name>inline-container block nested</name>
     <file>inline-container_block_nested.xml</file>
-    <description></description>
+    <description>Inline-container may not work as
+    expected.</description>
   </testcase>
   <testcase>
     <name>inline-container border padding</name>
     <file>inline-container_border_padding.xml</file>
-    <description></description>
+    <description>Inline-container may not work as
+    expected.</description>
   </testcase>
   <testcase>
     <name>inline letter-spacing</name>
     <file>inline_letter-spacing.xml</file>
-    <description></description>
+    <description>Letter-spacing may not work as
+    expected within fo:inline.</description>
   </testcase>
   <testcase>
     <name>inline word-spacing</name>
     <file>inline_word-spacing.xml</file>
-    <description></description>
+    <description>Word-spacing may not work as expected within
+    fo:inline.</description>
   </testcase>
   <testcase>
     <name>inline word-spacing text-align justify</name>
@@ -109,28 +126,34 @@
   <testcase>
     <name>leader alignment</name>
     <file>leader-alignment.xml</file>
-    <description></description>
+    <description>Leader-alignment is not yet
+    implemented.</description>
   </testcase>
   <testcase>
     <name>leader leader-pattern use-content_bug</name>
     <file>leader_leader-pattern_use-content_bug.xml</file>
-    <description></description>
+    <description>Line height is not correctly calculated for
+    use-content leaders whose height is larger than the rest of the
+    line.</description>
     <reference>http://issues.apache.org/bugzilla/show_bug.cgi?id=</reference>
   </testcase>
   <testcase>
     <name>list-block keep-with-previous</name>
     <file>list-block_keep-with-previous.xml</file>
-    <description></description>
+    <description>Keep-with-previous doesn't work inside tables and
+    lists, yet.</description>
   </testcase>
   <testcase>
     <name>list-item block keep-with-previous</name>
     <file>list-item_block_keep-with-previous.xml</file>
-    <description></description>
+    <description>Keep-with-previous doesn't work inside tables and
+    lists, yet.</description>
   </testcase>
   <testcase>
     <name>marker bug</name>
     <file>marker_bug.xml</file>
-    <description></description>
+    <description>White space on direct inline-level children of a
+    marker is not handled correctly.</description>
     <reference>http://issues.apache.org/bugzilla/show_bug.cgi?id=</reference>
   </testcase>
   <testcase>
@@ -151,7 +174,8 @@
   <testcase>
     <name>page-number-citation background-image</name>
     <file>page-number-citation_background-image.xml</file>
-    <description></description>
+    <description>Background-images on page-number-citations are not
+    placed correctly.</description>
   </testcase>
   <testcase>
     <name>page-number-citation complex 1</name>
@@ -171,28 +195,33 @@
   <testcase>
     <name>region-body column-count footnote</name>
     <file>region-body_column-count_footnote.xml</file>
-    <description></description>
+    <description>Footnotes may overlap with text of the region-body in
+    multi-column documents.</description>
   </testcase>
   <testcase>
     <name>region-body column-count bug36356</name>
     <file>region-body_column-count_bug36356.xml</file>
-    <description></description>
+    <description>Column balancing in multi-column documents may not
+    work as expected.</description>
     <reference>http://issues.apache.org/bugzilla/show_bug.cgi?id=36356</reference>
   </testcase>
   <testcase>
     <name>table-body background-image</name>
     <file>table-body_background-image.xml</file>
-    <description></description>
+    <description>The backgrounds of table-body, table-header,
+    table-footer and table-column are not painted, yet.</description>
   </testcase>
   <testcase>
     <name>table border-collapse collapse 1</name>
     <file>table_border-collapse_collapse_1.xml</file>
-    <description></description>
+    <description>Border-collapse="collapse" is not yet
+    implemented.</description>
   </testcase>
   <testcase>
     <name>table border-collapse collapse 2</name>
     <file>table_border-collapse_collapse_2.xml</file>
-    <description></description>
+    <description>Border-collapse="collapse" is not yet
+    implemented.</description>
   </testcase>
   <testcase>
     <name>table border padding</name>
@@ -202,12 +231,14 @@
   <testcase>
     <name>table-cell block keep-with-previous</name>
     <file>table-cell_block_keep-with-previous.xml</file>
-    <description></description>
+    <description>Keep-with-previous doesn't work inside tables and
+    lists, yet.</description>
   </testcase>
   <testcase>
     <name>table-cell_border padding_conditionality</name>
     <file>table-cell_border_padding_conditionality.xml</file>
-    <description></description>
+    <description>Border and padding conditionality are not supported
+    on table-cells, yet.</description>
   </testcase>
   <testcase>
     <name>table-column first-row-width</name>
@@ -217,12 +248,14 @@
   <testcase>
     <name>table-header background-image</name>
     <file>table-header_background-image.xml</file>
-    <description></description>
+    <description>The backgrounds of table-body, table-header,
+    table-footer and table-column are not painted, yet.</description>
   </testcase>
   <testcase>
     <name>table-row keep-with-previous</name>
     <file>table-row_keep-with-previous.xml</file>
-    <description></description>
+    <description>Keep-with-previous doesn't work inside tables and
+    lists, yet.</description>
   </testcase>
   <testcase>
     <name>table table-layout fixed 2</name>
@@ -232,6 +265,7 @@
   <testcase>
     <name>table border-width conditionality</name>
     <file>table_border-width_conditionality.xml</file>
-    <description></description>
+    <description>Border and padding conditionality are not supported
+    on table-cells, yet.</description>
   </testcase>
 </disabled-testcases>
\ No newline at end of file