Add breaking changes and release 1.0.0.

lib/src/line_scanner.dart

 // Copyright (c) 2014, 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.
 
 import 'package:charcode/ascii.dart';
 
 import 'string_scanner.dart';
 
 // Note that much of this code is duplicated in eager_span_scanner.dart.
 
 /// A regular expression matching newlines across platforms.
 final _newlineRegExp = new RegExp(r"\r\n?|\n");
 
 /// A subclass of [StringScanner] that tracks line and column information.
 class LineScanner extends StringScanner {
   /// The scanner's current (zero-based) line number.
   int get line => _line;
   int _line = 0;
 
   /// The scanner's current (zero-based) column number.
   int get column => _column;
   int _column = 0;
 
   /// The scanner's state, including line and column information.
   ///
   /// This can be used to efficiently save and restore the state of the scanner
   /// when backtracking. A given [LineScannerState] is only valid for the
   /// [LineScanner] that created it.
+  ///
+  /// This does not include the scanner's match information.
   LineScannerState get state =>
       new LineScannerState._(this, position, line, column);
 
   /// Whether the current position is between a CR character and an LF
   /// charactet.
   bool get _betweenCRLF => peekChar(-1) == $cr && peekChar() == $lf;
 
   set state(LineScannerState state) {
     if (!identical(state._scanner, this)) {
       throw new ArgumentError("The given LineScannerState was not returned by "
@@ skipping 88 matching lines @@
   final int position;
 
   /// The zero-based line number of the scanner in this state.
   final int line;
 
   /// The zero-based column number of the scanner in this state.
   final int column;
 
   LineScannerState._(this._scanner, this.position, this.line, this.column);
 }