================================================================================
ENGLISH
================================================================================

To launch the test software (you can edit this simple script to adapt
the classpath): 
./autotest.sh file
where file is an xml file containing the list of tests to perform.
You should redirect the output (html code) to a file so that you can
visualize the results through a browser.

Some xml examples files are giver in testsuite/xml.

Tests are grouped by type, so you can organize them better.
A test allows to check only one path/url.

For each test, you can specify a description and the expected result
(validity, errors and warnings count).

Some test examples:
- test from a URI:
    <test>
      <url>http://css.example.com/path/to/the/real/example.css</url>
      <description>example website</description>
      <result valid="false">
        <errors>24</errors>
        <warnings>0</warnings>
      </result>
    </test>
- test from a local file:
    <test>
      <file>testsuite/general/misc/sampleCSS1.css</file>
      <description>
	This style sheet is written according to the suggested rendering in the 
	HTML 2.0 specification. Some styles, e.g. colors, have been added for 
	completeness. It is suggested that a style sheet similar to this one 
	is used as the UA default.
      </description>
    </test>

the <test> element can take a number of parameters, with values equivalent to the optional 
parameters in the web service (see user manual for values listing):
examples:

    <test profile="css1"> ...</test>
    <test medium="print,screen">...</test>
    <test warning="2"> ...</test>

================================================================================
FRENCH
================================================================================

Pour lancer le programme (vous pouvez editer ce script pour adapter le
classpath):
./autotest.sh file
ou file est le fichier xml contenant la liste des tests a effectuer.
Il est conseille de rediriger la sortie (du code html) vers un fichier
afin de pouvoir visualiser les resultats depuis un navigateur.

Des exemples de fichiers xml sont presents dans testsuite/xml.

Les tests sont groupes par types, ce qui permet de savoir ce que l'on teste.
Un test permet de verifier un unique chemin/url.
On peut preciser pour chaque test une description, ainsi que le
resultat attendu (validite, nombre d'erreurs et de warnings).

Exemples de tests:
- une url:
    <test>
      <url>http://forums.jeuxonline.info</url>
      <description>Forum of a French online gaming website</description>
      <result valid="false">
        <errors>24</errors>
        <warnings>0</warnings>
      </result>
    </test>
- un fichier local:
    <test>
      <file>testsuite/general/misc/sampleCSS1.css</file>
      <description>
	This style sheet is written according to the suggested rendering in the 
	HTML 2.0 specification. Some styles, e.g. colors, have been added for 
	completeness. It is suggested that a style sheet similar to this one 
	is used as the UA default.
      </description>
 
L'element <test> peut prendre plusieurs parametres (profile, medium et warning)
dont les valeurs sont equivalentes a celles du service de validation (Cf. manuel
du validateur pour les valeurs acceptées).

exemples:

    <test profile="css1"> ...</test>
    <test medium="print,screen">...</test>
    <test warning="2"> ...</test>

   </test>
