[webkit-dev] Pixel tests and displaying text

[Maciej Stachowiak]

On Dec 8, 2010, at 2:03 PM, Darin Adler wrote:

> On Dec 8, 2010, at 1:23 PM, Simon Fraser wrote:
> 
>> On Dec 8, 2010, at 12:57 PM, Darin Adler wrote:
>> 
>>> On Dec 8, 2010, at 12:13 PM, Peter Kasting wrote:
>>> 
>>>> We could greatly decrease the number of these baselines by following a simple rule: don't display text unless you need to.
>>> 
>>> Seems like a good idea. I’m worried a bit, though, that if we can’t use any text in them at all, the tests are then not at all self explanatory. You have to be an expert on the test to understand what it’s testing and what success and failure look like.
>> 
>> Do HTML comments fulfill this?
> 
> Peter, Simon,
> 
> You both have convinced me that HTML comments could be fine for explaining what a test is testing. Maybe we could come up with a format that makes it likely we’ll spot those comments.
> 
> The success vs. failure aspects can probably be addressed by the “see no red” and other such things.

Maybe we could come up with a way to print the explanation in the browser only, and not in DumpRenderTree. A simple convention could be:

if (!window.layoutTestController)
    document.write("Explanation of what the test is testing goes here.");

This is slightly more convenient than an HTML comment when you open a test in the browser to see what's going on.

Regards,
Maciej