layout/reftests/w3c-css/submitted/README@925c144e1f1f (annotated)
layout/reftests/w3c-css/submitted/README
Fri, 16 Jan 2015 18:13:44 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Fri, 16 Jan 2015 18:13:44 +0100
- branch
- TOR_BUG_9701
- changeset 14
- 925c144e1f1f
- permissions
- -rw-r--r--
Integrate suggestion from review to improve consistency with existing code.
| michael@0 | 1 | W3C CSS Test Suite Submission Directory |
| michael@0 | 2 | --------------------------------------- |
| michael@0 | 3 | |
| michael@0 | 4 | Put tests here that are to be submitted to the official W3C CSS test |
| michael@0 | 5 | suites at http://test.csswg.org/. This directory will be sync'ed |
| michael@0 | 6 | automatically with the contributors/mozilla/ directory in the CSSWG |
| michael@0 | 7 | repository. The master copy is Mozilla's; make edits here, not there. |
| michael@0 | 8 | |
| michael@0 | 9 | Tests submitted here must conform to the CSSWG test format: |
| michael@0 | 10 | http://wiki.csswg.org/test/format |
| michael@0 | 11 | The extra metadata is there to connect tests to their respective specs |
| michael@0 | 12 | and to help reviewers and people trying to debug their implementations |
| michael@0 | 13 | understand and analyze the tests. (These are not write-only regression |
| michael@0 | 14 | tests.) |
| michael@0 | 15 | |
| michael@0 | 16 | TEST FILENAMES MUST BE GLOBALLY UNIQUE across the entire CSSWG test repo, |
| michael@0 | 17 | so don't rely on directory names as context. |
| michael@0 | 18 | |
| michael@0 | 19 | The W3C format uses <link> tags for connecting reftests to their |
| michael@0 | 20 | references and generates reftest.list from a build process. Until we |
| michael@0 | 21 | set up a build process here, you need to link up the reftest both ways. |
| michael@0 | 22 | |
| michael@0 | 23 | Because W3C sometimes needs to allow multiple correct renderings for |
| michael@0 | 24 | a particular case, a test linked to a reference must match ANY of them, |
| michael@0 | 25 | not all of them. To require a test to match all references, chain the |
| michael@0 | 26 | references to each other. If (a discrete number of) multiple renderings |
| michael@0 | 27 | are conformant, make a reftest comparison for each of them, and mark |
| michael@0 | 28 | all but the one we support as 'fails' in the reftest.list. |
| michael@0 | 29 | |
| michael@0 | 30 | You can copy the test-template-001.xht and references/test-template-001.xht |
| michael@0 | 31 | files in this directory as a starting point |
| michael@0 | 32 | |
| michael@0 | 33 | Submitted tests are tracked in Shepherd: http://test.csswg.org/shepherd/ |
| michael@0 | 34 | |
| michael@0 | 35 | Some things cannot be reftested; if another format is necessary to test |
| michael@0 | 36 | a particular feature, contact public-css-testsuite@w3.org and/or ask |
| michael@0 | 37 | the layout peers for help. |
| michael@0 | 38 | |
| michael@0 | 39 | Legal Stuff |
| michael@0 | 40 | ----------- |
| michael@0 | 41 | |
| michael@0 | 42 | The following license grant applies to contributions to this directory |
| michael@0 | 43 | (unless copyright is owned by a W3C Member, in which case the Membership |
| michael@0 | 44 | agreement applies): |
| michael@0 | 45 | |
| michael@0 | 46 | The Contributor hereby grants to the W3C, a perpetual, non-exclusive, |
| michael@0 | 47 | royalty-free, world-wide right and license under any Contributor |
| michael@0 | 48 | copyrights in this contribution to copy, publish, use, and modify the |
| michael@0 | 49 | contribution and to distribute the contribution under a BSD License or one |
| michael@0 | 50 | with more restrictive terms, as well as a right and license of the same |
| michael@0 | 51 | scope to any derivative works prepared by the W3C and based on, or |
| michael@0 | 52 | incorporating all or part of the contribution. The Contributor further |
| michael@0 | 53 | agrees that any derivative works of this contribution prepared by the W3C |
| michael@0 | 54 | shall be solely owned by the W3C. |
| michael@0 | 55 | |
| michael@0 | 56 | The Contributor states, to the best of her/his knowledge, that she/he, |
| michael@0 | 57 | or the company she/he represents, has all rights necessary to contribute |
| michael@0 | 58 | the Materials. |
| michael@0 | 59 | |
| michael@0 | 60 | W3C will retain attribution of initial authorship to the Contributor. The |
| michael@0 | 61 | W3C makes no a-priori commitment to support or distribute contributions. |
| michael@0 | 62 | |
| michael@0 | 63 | THE CONTRIBUTION IS PROVIDED AS IS, AND CONTRIBUTORS MAKE NO REPRESENTATIONS OR |
| michael@0 | 64 | WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF |
| michael@0 | 65 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; |
| michael@0 | 66 | THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE. CONTRIBUTORS |
| michael@0 | 67 | MAKE NO REPRESENTATIONS, EXPRESS OR IMPLIED, THAT THE CONTRIBUTION OR THE USE |
| michael@0 | 68 | THEREOF INDICATES CONFORMANCE TO A SPECIFICATION; CONTRIBUTIONS ARE PROVIDED |
| michael@0 | 69 | ONLY TO HELP REACHING INTEROPERABILITY. |
