OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 /** | 5 /** |
6 * This generates the reference documentation for the core libraries that come | 6 * This generates the reference documentation for the core libraries that come |
7 * with dart. It is built on top of dartdoc, which is a general-purpose library | 7 * with dart. It is built on top of dartdoc, which is a general-purpose library |
8 * for generating docs from any Dart code. This library extends that to include | 8 * for generating docs from any Dart code. This library extends that to include |
9 * additional information and styling specific to our standard library. | 9 * additional information and styling specific to our standard library. |
10 * | 10 * |
(...skipping 91 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
102 | 102 |
103 // TODO(johnniwinther): Libraries for the compilation seem to be more like | 103 // TODO(johnniwinther): Libraries for the compilation seem to be more like |
104 // URIs. Perhaps Path should have a toURI() method. | 104 // URIs. Perhaps Path should have a toURI() method. |
105 // Add all of the core libraries. | 105 // Add all of the core libraries. |
106 final apidocLibraries = <Path>[]; | 106 final apidocLibraries = <Path>[]; |
107 DART2JS_LIBRARY_MAP.forEach((String name, LibraryInfo info) { | 107 DART2JS_LIBRARY_MAP.forEach((String name, LibraryInfo info) { |
108 if (!info.isInternal) { | 108 if (!info.isInternal) { |
109 apidocLibraries.add(new Path('dart:$name')); | 109 apidocLibraries.add(new Path('dart:$name')); |
110 } | 110 } |
111 }); | 111 }); |
112 apidocLibraries.add(doc.scriptDir.append('../../lib/unittest/unittest.dart')); | 112 apidocLibraries.add(doc.scriptDir.append('../../pkg/unittest/unittest.dart')); |
113 apidocLibraries.add(doc.scriptDir.append('../../pkg/i18n/intl.dart')); | 113 apidocLibraries.add(doc.scriptDir.append('../../pkg/i18n/intl.dart')); |
114 | 114 |
115 print('Generating docs...'); | 115 print('Generating docs...'); |
116 final apidoc = new Apidoc(mdn, htmldoc, outputDir, mode, generateAppCache); | 116 final apidoc = new Apidoc(mdn, htmldoc, outputDir, mode, generateAppCache); |
117 // Select the libraries to include in the produced documentation: | 117 // Select the libraries to include in the produced documentation: |
118 apidoc.includeApi = true; | 118 apidoc.includeApi = true; |
119 apidoc.includedLibraries = <String>[ | 119 apidoc.includedLibraries = <String>[ |
120 'unittest', | 120 'unittest', |
121 'intl', | 121 'intl', |
122 ]; | 122 ]; |
(...skipping 392 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
515 final typeName = member.surroundingDeclaration.simpleName; | 515 final typeName = member.surroundingDeclaration.simpleName; |
516 var memberName = '$typeName.${member.simpleName}'; | 516 var memberName = '$typeName.${member.simpleName}'; |
517 if (member is MethodMirror && (member.isConstructor || member.isFactory)) { | 517 if (member is MethodMirror && (member.isConstructor || member.isFactory)) { |
518 final separator = member.constructorName == '' ? '' : '.'; | 518 final separator = member.constructorName == '' ? '' : '.'; |
519 memberName = 'new $typeName$separator${member.constructorName}'; | 519 memberName = 'new $typeName$separator${member.constructorName}'; |
520 } | 520 } |
521 | 521 |
522 return a(memberUrl(member), memberName); | 522 return a(memberUrl(member), memberName); |
523 } | 523 } |
524 } | 524 } |
OLD | NEW |