| OLD | NEW |
| 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, 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 docgen.generator; | 5 library docgen.generator; |
| 6 | 6 |
| 7 import 'dart:async'; | 7 import 'dart:async'; |
| 8 import 'dart:collection'; | 8 import 'dart:collection'; |
| 9 import 'dart:convert'; | 9 import 'dart:convert'; |
| 10 import 'dart:io'; | 10 import 'dart:io'; |
| (...skipping 405 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 416 void generateLibrary(dart2js_mirrors.Dart2JsLibraryMirror library) { | 416 void generateLibrary(dart2js_mirrors.Dart2JsLibraryMirror library) { |
| 417 var result = new Library(library); | 417 var result = new Library(library); |
| 418 result.updateLibraryPackage(library); | 418 result.updateLibraryPackage(library); |
| 419 logger.fine('Generated library for ${result.name}'); | 419 logger.fine('Generated library for ${result.name}'); |
| 420 } | 420 } |
| 421 | 421 |
| 422 /// If we can't find the SDK introduction text, which will happen if running | 422 /// If we can't find the SDK introduction text, which will happen if running |
| 423 /// from a snapshot and using --parse-sdk or --include-sdk, then use this | 423 /// from a snapshot and using --parse-sdk or --include-sdk, then use this |
| 424 /// hard-coded version. This should be updated to be consistent with the text | 424 /// hard-coded version. This should be updated to be consistent with the text |
| 425 /// in docgen/doc/sdk-introduction.md | 425 /// in docgen/doc/sdk-introduction.md |
| 426 // TODO(alanknight): It would be better if we could resolve the references to |
| 427 // dart:core etc. at load-time in the viewer. dartbug.com/20112 |
| 426 const _DEFAULT_SDK_INTRODUCTION = | 428 const _DEFAULT_SDK_INTRODUCTION = |
| 427 """ | 429 """ |
| 428 Welcome to the Dart API reference documentation, | 430 Welcome to the Dart API reference documentation, |
| 429 covering the official Dart API libraries. | 431 covering the official Dart API libraries. |
| 430 Some of the most fundamental Dart libraries include: | 432 Some of the most fundamental Dart libraries include: |
| 431 | 433 |
| 432 * [dart:core](#dart:core): | 434 * [dart:core](./dart:core): |
| 433 Core functionality such as strings, numbers, collections, errors, | 435 Core functionality such as strings, numbers, collections, errors, |
| 434 dates, and URIs. | 436 dates, and URIs. |
| 435 * [dart:html](#dart:html): | 437 * [dart:html](./dart:html): |
| 436 DOM manipulation for web apps. | 438 DOM manipulation for web apps. |
| 437 * [dart:io](#dart:io): | 439 * [dart:io](./dart:io): |
| 438 I/O for command-line apps. | 440 I/O for command-line apps. |
| 439 | 441 |
| 440 Except for dart:core, you must import a library before you can use it. | 442 Except for dart:core, you must import a library before you can use it. |
| 441 Here's an example of importing dart:html, dart:math, and a | 443 Here's an example of importing dart:html, dart:math, and a |
| 442 third popular library called | 444 third popular library called |
| 443 [polymer.dart](http://www.dartlang.org/polymer-dart/): | 445 [polymer.dart](http://www.dartlang.org/polymer-dart/): |
| 444 | 446 |
| 445 import 'dart:html'; | 447 import 'dart:html'; |
| 446 import 'dart:math'; | 448 import 'dart:math'; |
| 447 import 'package:polymer/polymer.dart'; | 449 import 'package:polymer/polymer.dart'; |
| (...skipping 15 matching lines...) Expand all Loading... |
| 463 * [Samples](http://www.dartlang.org/samples/) | 465 * [Samples](http://www.dartlang.org/samples/) |
| 464 * [A Tour of the Dart Libraries](http://www.dartlang.org/docs/dart-up-and-runn
ing/contents/ch03.html) | 466 * [A Tour of the Dart Libraries](http://www.dartlang.org/docs/dart-up-and-runn
ing/contents/ch03.html) |
| 465 | 467 |
| 466 This API reference is automatically generated from the source code in the | 468 This API reference is automatically generated from the source code in the |
| 467 [Dart project](https://code.google.com/p/dart/). | 469 [Dart project](https://code.google.com/p/dart/). |
| 468 If you'd like to contribute to this documentation, see | 470 If you'd like to contribute to this documentation, see |
| 469 [Contributing](https://code.google.com/p/dart/wiki/Contributing) | 471 [Contributing](https://code.google.com/p/dart/wiki/Contributing) |
| 470 and | 472 and |
| 471 [Writing API Documentation](https://code.google.com/p/dart/wiki/WritingApiDocume
ntation). | 473 [Writing API Documentation](https://code.google.com/p/dart/wiki/WritingApiDocume
ntation). |
| 472 """; | 474 """; |
| OLD | NEW |