summaryrefslogtreecommitdiffstats
path: root/layout/reftests/w3c-css/submitted/README
diff options
context:
space:
mode:
Diffstat (limited to 'layout/reftests/w3c-css/submitted/README')
-rw-r--r--layout/reftests/w3c-css/submitted/README69
1 files changed, 69 insertions, 0 deletions
diff --git a/layout/reftests/w3c-css/submitted/README b/layout/reftests/w3c-css/submitted/README
new file mode 100644
index 000000000..ec0c0a6a2
--- /dev/null
+++ b/layout/reftests/w3c-css/submitted/README
@@ -0,0 +1,69 @@
+W3C CSS Test Suite Submission Directory
+---------------------------------------
+
+Put tests here that are to be submitted to the official W3C CSS test
+suites at http://test.csswg.org/. This directory will be sync'ed
+automatically with the contributors/mozilla/ directory in the CSSWG
+repository. The master copy is Mozilla's; make edits here, not there.
+
+Tests submitted here must conform to the CSSWG test format:
+ http://wiki.csswg.org/test/format
+The extra metadata is there to connect tests to their respective specs
+and to help reviewers and people trying to debug their implementations
+understand and analyze the tests. (These are not write-only regression
+tests.)
+
+TEST FILENAMES MUST BE GLOBALLY UNIQUE across the entire CSSWG test repo,
+so don't rely on directory names as context.
+
+The W3C format uses <link> tags for connecting reftests to their
+references and generates reftest.list from a build process. Until we
+set up a build process here, you need to link up the reftest both ways.
+
+Because W3C sometimes needs to allow multiple correct renderings for
+a particular case, a test linked to a reference must match ANY of them,
+not all of them. To require a test to match all references, chain the
+references to each other. If (a discrete number of) multiple renderings
+are conformant, make a reftest comparison for each of them, and mark
+all but the one we support as 'fails' in the reftest.list.
+
+You can copy the test-template-001.xht and references/test-template-001.xht
+files in this directory as a starting point
+
+Submitted tests are tracked in Shepherd: http://test.csswg.org/shepherd/
+
+Some things cannot be reftested; if another format is necessary to test
+a particular feature, contact public-css-testsuite@w3.org and/or ask
+the layout peers for help.
+
+Legal Stuff
+-----------
+
+The following license grant applies to contributions to this directory
+(unless copyright is owned by a W3C Member, in which case the Membership
+agreement applies):
+
+ The Contributor hereby grants to the W3C, a perpetual, non-exclusive,
+ royalty-free, world-wide right and license under any Contributor
+ copyrights in this contribution to copy, publish, use, and modify the
+ contribution and to distribute the contribution under a BSD License or one
+ with more restrictive terms, as well as a right and license of the same
+ scope to any derivative works prepared by the W3C and based on, or
+ incorporating all or part of the contribution. The Contributor further
+ agrees that any derivative works of this contribution prepared by the W3C
+ shall be solely owned by the W3C.
+
+ The Contributor states, to the best of her/his knowledge, that she/he,
+ or the company she/he represents, has all rights necessary to contribute
+ the Materials.
+
+ W3C will retain attribution of initial authorship to the Contributor. The
+ W3C makes no a-priori commitment to support or distribute contributions.
+
+ THE CONTRIBUTION IS PROVIDED AS IS, AND CONTRIBUTORS MAKE NO REPRESENTATIONS OR
+ WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE;
+ THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE. CONTRIBUTORS
+ MAKE NO REPRESENTATIONS, EXPRESS OR IMPLIED, THAT THE CONTRIBUTION OR THE USE
+ THEREOF INDICATES CONFORMANCE TO A SPECIFICATION; CONTRIBUTIONS ARE PROVIDED
+ ONLY TO HELP REACHING INTEROPERABILITY.