Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(131)

Side by Side Diff: pkg/docgen/lib/docgen.dart

Issue 304203004: Correctly handle case where we have a library outside of a package. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Created 6 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
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 24 matching lines...) Expand all
35 /// viewer with dart2js. 35 /// viewer with dart2js.
36 /// If [serve] is `true`, then after generating the documents we fire up a 36 /// If [serve] is `true`, then after generating the documents we fire up a
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, String pubScript, 45 bool serve: false, bool noDocs: false, String startPage,
46 String dartBinary, bool indentJSON: false}) { 46 String pubScript : 'pub', String dartBinary: 'dart',
47 bool indentJSON: false}) {
47 var result; 48 var result;
48 if (!noDocs) { 49 if (!noDocs) {
49 viewer.ensureMovedViewerCode(); 50 viewer.ensureMovedViewerCode();
50 result = gen.generateDocumentation(files, packageRoot: packageRoot, 51 result = gen.generateDocumentation(files, packageRoot: packageRoot,
51 includePrivate: includePrivate, 52 includePrivate: includePrivate,
52 includeSdk: includeSdk, parseSdk: parseSdk, 53 includeSdk: includeSdk, parseSdk: parseSdk,
53 introFileName: introFileName, out: out, 54 introFileName: introFileName, out: out,
54 excludeLibraries: excludeLibraries, 55 excludeLibraries: excludeLibraries,
55 includeDependentPackages: includeDependentPackages, 56 includeDependentPackages: includeDependentPackages,
56 startPage: startPage, pubScriptValue: pubScript, 57 startPage: startPage, pubScriptValue: pubScript,
57 dartBinaryValue: dartBinary, indentJSON: indentJSON); 58 dartBinaryValue: dartBinary, indentJSON: indentJSON);
58 viewer.addBackViewerCode(); 59 viewer.addBackViewerCode();
59 if (compile || serve) { 60 if (compile || serve) {
60 result.then((success) { 61 result.then((success) {
61 if (success) { 62 if (success) {
62 viewer.createViewer(serve); 63 viewer.createViewer(serve);
63 } 64 }
64 }); 65 });
65 } 66 }
66 } else if (compile || serve) { 67 } else if (compile || serve) {
67 gen.pubScript = pubScript; 68 gen.pubScript = pubScript;
68 gen.dartBinary = dartBinary; 69 gen.dartBinary = dartBinary;
69 viewer.createViewer(serve); 70 viewer.createViewer(serve);
70 } 71 }
71 return result; 72 return result;
72 } 73 }
OLDNEW
« no previous file with comments | « no previous file | pkg/docgen/lib/src/generator.dart » ('j') | pkg/docgen/lib/src/package_helpers.dart » ('J')

Powered by Google App Engine
This is Rietveld 408576698