Fix broken comment references (#89)

* Fix broken comment references

* feedback

.gitignore

@@ -1,3 +1,4 @@
 .dart_tool/
 .packages
 pubspec.lock
+doc/api/

lib/src/characters.dart

@@ -49,8 +49,8 @@ abstract class Characters implements Iterable<String> {
   /// Returns [CharacterRange] positioned after the last character
   /// of this [Characters].
   ///
-  /// Allows iterating the characters of [string] backwards
-  /// using [CharacterRange.movePrevious],
+  /// Allows iterating the characters of [string] backwards using
+  /// [CharacterRange.moveBack],
   /// as well as controlling the iteration in more detail.
   CharacterRange get iteratorAtEnd;
 
@@ -62,7 +62,7 @@ abstract class Characters implements Iterable<String> {
   /// and that character is one of the characters
   /// in this character sequence, and false otherwise.
   /// This behavior is inherited from `Iterable<String>`,
-  /// which is why it is not [Character] based.
+  /// which is why it is not [Characters]-based.
   /// Use [containsAll] for a method which acts like
   /// [String.contains] for characters.
   @override
@@ -390,8 +390,7 @@ abstract class CharacterRange implements Iterator<String> {
   /// The copy is in the exact same state as this iterator.
   /// Can be used to iterate the following characters more than once
   /// at the same time. To simply rewind an iterator, remember the
-  /// [start] or [end] position and use [reset] to reset the iterator
-  /// to that position.
+  /// start or end position and use reset the iterator to that position.
   CharacterRange copy();
 
   /// Whether the current range is empty.

lib/src/characters_impl.dart

@@ -464,15 +464,15 @@ class StringCharacterRange implements CharacterRange {
 
   /// Creates a [Breaks] from [_end] to `_string.length`.
   ///
-  /// Uses information stored in [_state] for cases where the next
-  /// character has already been seen.
+  /// Uses information stored in the state for cases where the next character
+  /// has already been seen.
   Breaks _breaksFromEnd() {
     return Breaks(_string, _end, _string.length, stateSoTNoBreak);
   }
 
   /// Creates a [Breaks] from string start to [_start].
   ///
-  /// Uses information stored in [_state] for cases where the previous
+  /// Uses information stored in the state for cases where the previous
   /// character has already been seen.
   BackBreaks _backBreaksFromStart() {
     return BackBreaks(_string, _start, 0, stateEoTNoBreak);

tool/src/atsp.dart

@@ -12,7 +12,7 @@
 
 /// An asymmetric weighted complete graph.
 ///
-/// The vertices are identified by numbers 0 through [vertices] - 1.
+/// The vertices are identified by numbers 0 through [vertexCount] - 1.
 /// Edges are pairs of vertices.
 class Graph {
   /// Number of vertices.