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