| 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 /// **docgen** is a tool for creating machine readable representations of Dart | 5 /// **docgen** is a tool for creating machine readable representations of Dart |
| 6 /// code metadata, including: classes, members, comments and annotations. | 6 /// code metadata, including: classes, members, comments and annotations. |
| 7 /// | 7 /// |
| 8 /// docgen is run on a `.dart` file or a directory containing `.dart` files. | 8 /// docgen is run on a `.dart` file or a directory containing `.dart` files. |
| 9 /// | 9 /// |
| 10 /// $ dart docgen.dart [OPTIONS] [FILE/DIR] | 10 /// $ dart docgen.dart [OPTIONS] [FILE/DIR] |
| (...skipping 26 matching lines...) Expand all Loading... |
| 37 /// simple server to view the documentation. | 37 /// simple server to view the documentation. |
| 38 /// | 38 /// |
| 39 /// Returned Future completes with true if document generation is successful. | 39 /// Returned Future completes with true if document generation is successful. |
| 40 Future<bool> docgen(List<String> files, {String packageRoot, | 40 Future<bool> docgen(List<String> files, {String packageRoot, |
| 41 bool includePrivate: false, bool includeSdk: false, bool parseSdk: false, | 41 bool includePrivate: false, bool includeSdk: false, bool parseSdk: false, |
| 42 String introFileName: '', String out: gen.DEFAULT_OUTPUT_DIRECTORY, | 42 String introFileName: '', String out: gen.DEFAULT_OUTPUT_DIRECTORY, |
| 43 List<String> excludeLibraries: const [], | 43 List<String> excludeLibraries: const [], |
| 44 bool includeDependentPackages: false, bool compile: false, | 44 bool includeDependentPackages: false, bool compile: false, |
| 45 bool serve: false, bool noDocs: false, String startPage, | 45 bool serve: false, bool noDocs: false, String startPage, |
| 46 String pubScript : 'pub', String dartBinary: 'dart', | 46 String pubScript : 'pub', String dartBinary: 'dart', |
| 47 bool indentJSON: false}) { | 47 bool indentJSON: false, String sdk}) { |
| 48 var result; | 48 var result; |
| 49 if (!noDocs) { | 49 if (!noDocs) { |
| 50 viewer.ensureMovedViewerCode(); | 50 viewer.ensureMovedViewerCode(); |
| 51 result = gen.generateDocumentation(files, packageRoot: packageRoot, | 51 result = gen.generateDocumentation(files, packageRoot: packageRoot, |
| 52 includePrivate: includePrivate, | 52 includePrivate: includePrivate, |
| 53 includeSdk: includeSdk, parseSdk: parseSdk, | 53 includeSdk: includeSdk, parseSdk: parseSdk, |
| 54 introFileName: introFileName, out: out, | 54 introFileName: introFileName, out: out, |
| 55 excludeLibraries: excludeLibraries, | 55 excludeLibraries: excludeLibraries, |
| 56 includeDependentPackages: includeDependentPackages, | 56 includeDependentPackages: includeDependentPackages, |
| 57 startPage: startPage, pubScriptValue: pubScript, | 57 startPage: startPage, pubScriptValue: pubScript, |
| 58 dartBinaryValue: dartBinary, indentJSON: indentJSON); | 58 dartBinaryValue: dartBinary, indentJSON: indentJSON, sdk: sdk); |
| 59 viewer.addBackViewerCode(); | 59 viewer.addBackViewerCode(); |
| 60 if (compile || serve) { | 60 if (compile || serve) { |
| 61 result.then((success) { | 61 result.then((success) { |
| 62 if (success) { | 62 if (success) { |
| 63 viewer.createViewer(serve); | 63 viewer.createViewer(serve); |
| 64 } | 64 } |
| 65 }); | 65 }); |
| 66 } | 66 } |
| 67 } else if (compile || serve) { | 67 } else if (compile || serve) { |
| 68 gen.pubScript = pubScript; | 68 gen.pubScript = pubScript; |
| 69 gen.dartBinary = dartBinary; | 69 gen.dartBinary = dartBinary; |
| 70 viewer.createViewer(serve); | 70 viewer.createViewer(serve); |
| 71 } | 71 } |
| 72 return result; | 72 return result; |
| 73 } | 73 } |
| OLD | NEW |