| OLD | NEW |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 /// Library to create and parse source maps. | 5 /// Library to create and parse source maps. |
| 6 /// | 6 /// |
| 7 /// Create a source map using [SourceMapBuilder]. For example: | 7 /// Create a source map using [SourceMapBuilder]. For example: |
| 8 /// var json = (new SourceMapBuilder() | 8 /// var json = (new SourceMapBuilder() |
| 9 /// ..add(inputSpan1, outputSpan1) | 9 /// ..add(inputSpan1, outputSpan1) |
| 10 /// ..add(inputSpan2, outputSpan2) | 10 /// ..add(inputSpan2, outputSpan2) |
| 11 /// ..add(inputSpan3, outputSpan3) | 11 /// ..add(inputSpan3, outputSpan3) |
| 12 /// .toJson(outputFile); | 12 /// .toJson(outputFile); |
| 13 /// | 13 /// |
| 14 /// Use the [Span] and [SourceFile] classes to specify span locations. | 14 /// Use the source_span package's [SourceSpan] and [SourceFile] classes to |
| 15 /// specify span locations. |
| 15 /// | 16 /// |
| 16 /// Parse a source map using [parse], and call `spanFor` on the returned mapping | 17 /// Parse a source map using [parse], and call `spanFor` on the returned mapping |
| 17 /// object. For example: | 18 /// object. For example: |
| 18 /// var mapping = parse(json); | 19 /// var mapping = parse(json); |
| 19 /// mapping.spanFor(outputSpan1.line, outputSpan1.column) | 20 /// mapping.spanFor(outputSpan1.line, outputSpan1.column) |
| 20 /// | 21 /// |
| 21 /// ## Getting the code ## | 22 /// ## Getting the code ## |
| 22 /// | 23 /// |
| 23 /// This library is distributed as a [pub][] package. To install this package, | 24 /// This library is distributed as a [pub][] package. To install this package, |
| 24 /// add the following to your `pubspec.yaml` file: | 25 /// add the following to your `pubspec.yaml` file: |
| 25 /// | 26 /// |
| 26 /// dependencies: | 27 /// dependencies: |
| 27 /// source_maps: any | 28 /// source_maps: any |
| 28 /// | 29 /// |
| 29 /// After you run `pub install`, you should be able to access this library by | 30 /// After you run `pub install`, you should be able to access this library by |
| 30 /// importing `package:source_maps/source_maps.dart`. | 31 /// importing `package:source_maps/source_maps.dart`. |
| 31 /// | 32 /// |
| 32 /// For more information, see the | 33 /// For more information, see the |
| 33 /// [source_maps package on pub.dartlang.org][pkg]. | 34 /// [source_maps package on pub.dartlang.org][pkg]. |
| 34 /// | 35 /// |
| 35 /// [pub]: http://pub.dartlang.org | 36 /// [pub]: http://pub.dartlang.org |
| 36 /// [pkg]: http://pub.dartlang.org/packages/source_maps | 37 /// [pkg]: http://pub.dartlang.org/packages/source_maps |
| 37 library source_maps; | 38 library source_maps; |
| 38 | 39 |
| 39 export "builder.dart"; | 40 export "builder.dart"; |
| 40 export "parser.dart"; | 41 export "parser.dart"; |
| 41 export "printer.dart"; | 42 export "printer.dart"; |
| 42 export "refactor.dart"; | 43 export "refactor.dart"; |
| 43 export "span.dart"; | 44 export 'src/source_map_span.dart'; |
| OLD | NEW |