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 |