Fix comments in test expectations. Also, the description in my previous...

webkit/tools/layout_tests/test_expectations.txt

 // This file consists of lines with specifications of what
 // to expect from layout test cases. The test cases can be directories
 // in which case the expectations apply to all test cases in that
 // directory and any subdirectory. The format of the file is along the
 // lines of:
 //
 // LayoutTests/fast/js/fixme.js = FAIL
 // LayoutTests/fast/js/flaky.js = FAIL PASS
 // LayoutTests/fast/js/crash.js = CRASH TIMEOUT FAIL PASS
 //
-// To add other options:
-// SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
-// DEBUG : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
-// DEBUG SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
-// LINUX DEBUG SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
-// BUG1234 DEBUG MAC : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+// The format of a test line is as follows:
+// METADATA : relative/path/to/test.html = EXPECTATIONS
+//
+// Valid values for METADATA:
 //
 // BUG[0-9]+: See this bug for more information. Every test that isn't marked
 //            WONTFIX should have a BUG annotation.
 // SKIP: Doesn't run the test.
 // SLOW: The test takes a long time to run, but does not timeout indefinitely.
 // WONTFIX: For tests that we never intend to pass on a given platform.
 // DEBUG: Expectations apply only to the debug build.
 // RELEASE: Expectations apply only to release build.
-// LINUX/WIN/MAC: Expectations apply only to these platforms.
+// LINUX/WIN/WIN-XP/WIN-VISTA/MAC: Expectations apply only to these platforms.
 //
-// The format of a test line is as follows:
-// METADATA : relative/path/to/test.html = EXPECTATIONS
+// Valid values for EXPECTATIONS:
+//
+// PASS: Test should pass
+// CRASH: Test should crash
+// TIMEOUT: Test should timeout
+// IMAGE: Test will produce an incorrect image dump
+// TEXT: Test will produce incorrect text output (either full or simplified)
+// IMAGE+TEXT: Test will produce both incorrect text and images
+// FAIL: Test will produce either incorrect text, images, or both
+//
+// If a line contains multiple expectations, it is considered "flakey",
+// because it means that we're not producing consistent, reliable results.
 //
 // For example,
 // LINUX : LayoutTests/media = PASS FAIL
 //
 // The above means that all the media tests are flaky, but only on Linux.
 //
+// Other examples:
+//
+// SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+// DEBUG : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+// DEBUG SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+// LINUX DEBUG SKIP : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+// BUG1234 DEBUG MAC : LayoutTests/fast/js/no-good.js = TIMEOUT PASS
+//
 // Notes:
 // -A test cannot be both SLOW and TIMEOUT
 // -A test can be included twice, but not via the same path.
 // -If a test is included twice, then the more precise path wins.
 // -CRASH tests cannot be WONTFIX
 
 // -----------------------------------------------------------------
 // SLOW TESTS
 // -----------------------------------------------------------------
 
@@ skipping 2283 matching lines @@
 BUG_DGLAZKOV : LayoutTests/fast/loader/fragment-after-redirect-gets-back-entry.html = FAIL
 
 // WebKit update 48684:48700
 BUG_DGLAZKOV : LayoutTests/fast/forms/textarea-maxlength.html = FAIL
 
 // WebKit update 48700:48721
 BUG_DGLAZKOV : LayoutTests/http/tests/xmlhttprequest/xmlhttprequest-abort-readyState-shouldDispatchEvent.html = FAIL
 
 // WebKit update 48734:48747
 BUG_LEVIN : LayoutTests/platform/gtk/scrollbars/overflow-scrollbar-horizontal-wheel-scroll.html = TIMEOUT