Lint to detect dangling identifiers in docs (#240).

test/rules/comment_references.dart

Index: test/rules/comment_references.dart
diff --git a/test/rules/comment_references.dart b/test/rules/comment_references.dart
new file mode 100644
index 0000000000000000000000000000000000000000..3b9c56d9f46981077b7a7bfb17187083f337486a
--- /dev/null
+++ b/test/rules/comment_references.dart
@@ -0,0 +1,20 @@
+// Copyright (c) 2016, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// test w/ `dart test/util/solo_test.dart comment_references`
+
+/// Writes [y]. #LINT
+void write(int x) {}
+
+/// [String] is OK.
+class A {
+  /// But [zap] is not. #LINT
+  int z;
+
+  /// Reads [x] and assigns to [z]. #OK
+  void read(int x) {}
+
+  /// Writes [y]. #LINT
+  void write(int x) {}
+}