Update documentation on Symbol. Make validation match.

tests/lib/mirrors/symbol_validation_test.dart

Index: tests/lib/mirrors/symbol_validation_test.dart
diff --git a/tests/lib/mirrors/symbol_validation_test.dart b/tests/lib/mirrors/symbol_validation_test.dart
index 0fe3c45c3d412b142226754f67f66ee0473c4d18..6702c2da21611d37e0f606ce23b99b1b181a0100 100644
--- a/tests/lib/mirrors/symbol_validation_test.dart
+++ b/tests/lib/mirrors/symbol_validation_test.dart
@@ -26,14 +26,91 @@ invalidSymbol(String string) {
 }
 
 main() {
-  ['%', '&', '*', '+', '-', '/', '<', '<<', '<=', '==', '>',
-   '>=', '>>', '[]', '[]=', '^', 'unary-', '|', '~', '~/']
-      .forEach(validSymbol);
+  // Operators that can be declared as class member operators.
+  // These are all valid as symbols.
+  var operators = [
+    '%', '&', '*', '+', '-', '/', '<', '<<', '<=', '==', '>',
+    '>=', '>>', '[]', '[]=', '^', 'unary-', '|', '~', '~/'
+  ];
+  operator.forEach(validSymbol);
 
-  ['foo', '_bar', 'baz.quz', 'fisk1', 'hest2fisk', 'a.b.c.d.e',
-   '\$', 'foo\$', 'bar\$bar']
-      .forEach(validSymbol);
+  var simpleSymbols = [
+    'foo', '_bar', 'baz.quz', 'fisk1', 'hest2fisk', 'a.b.c.d.e',
+    r'$', r'foo$', r'bar$bar', r'$.$', r'x6$_', r'$6_', r'x.$$6_',
+    'x_', 'x_.x_',
+  ];
+  simpleSymbols.forEach(validSymbol);
 
-  ['6', '0foo', ',', 'S with M', '_invalid&private']
-      .forEach(invalidSymbol);
+  var nonSymbols = [
+    // Non-identifiers.
+    '6', '0foo', ',', 'S with M', '_invalid&private', "#foo", " foo", "foo ",
+    // Operator variants.
+    '+=', '()', 'operator+', 'unary+', '>>>', "&&", "||", "!", "@", "#", "[",
+    // Privat symbols.
+    '_x', 'x._y', 'x._',
+    // Empty parts of "qualified" symbols.
+    '.', 'x.', '.x', 'x..y'
+  ];
+  nonSymbols.forEach(invalidSymbol);
+
+  // Reserved words are not valid identifiers and therefore not valid symbols.
+  var reservedWords = [
+    "assert",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "default",
+    "do",
+    "else",
+    "enum",
+    "extends",
+    "false",
+    "final",
+    "finally",
+    "for",
+    "if",
+    "in",
+    "is",
+    "new",
+    "null",
+    "rethrow",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "var",
+    "void",
+    "while",
+    "with"
+  ];
+  reservedWords.expand((w) => [w, "$w=", "x.$w" , "$w.x", "x.$w.x"])
+               .forEach(invalidSymbol);
+
+  // Built-in identifiers are valid identifiers that are restricted from being
+  // used in some cases, but they are all valid symbols.
+  var builtInIdentifiers = [
+    "abstract",
+    "as",
+    "dynamic",
+    "export",
+    "external",
+    "factory",
+    "get",
+    "implements",
+    "import",
+    "library",
+    "operator",
+    "part",
+    "set",
+    "static",
+    "typedef"
+  ];
+  builtInIdentifiers.expand((w) => [w, "$w=", "x.$w" , "$w.x", "x.$w.x"])
+                    .forEach(validSymbol);
 }