Getting docgen to work with the SDK.

pkg/docgen/lib/docgen.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * **docgen** is a tool for creating machine readable representations of Dart 
  * code metadata, including: classes, members, comments and annotations.
  * 
  * docgen is run on a `.dart` file or a directory containing `.dart` files. 
  * 
@@ skipping 15 matching lines @@
 
 import 'dart2yaml.dart';
 import 'src/io.dart';
 import '../../../sdk/lib/_internal/compiler/compiler.dart' as api;
 import '../../../sdk/lib/_internal/compiler/implementation/filenames.dart';
 import '../../../sdk/lib/_internal/compiler/implementation/mirrors/dart2js_mirror.dart'
     as dart2js;
 import '../../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors.dart';
 import '../../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors_util.dart';
 import '../../../sdk/lib/_internal/compiler/implementation/source_file_provider.dart';
+import '../../../sdk/lib/_internal/libraries.dart';
 
 var logger = new Logger('Docgen');
 
 const String usage = 'Usage: dart docgen.dart [OPTIONS] [fooDir/barFile]';
 
 /**
  * This class documents a list of libraries.
  */
 class Docgen {
 
@@ skipping 11 matching lines @@
   
   /// Resolves reference links in doc comments. 
   markdown.Resolver linkResolver;
   
   /// Package directory of directory being analyzed. 
   String packageDir;
   
   bool outputToYaml;
   bool outputToJson;
   bool includePrivate;
-  /// State for whether or not the SDK libraries should also be outputted.
+  /// State for whether imported SDK libraries should also be outputted.
   bool includeSdk;
+  /// State for whether all SDK libraries should be outputted. 
+  bool parseSdk;
 
   /**
    * Docgen constructor initializes the link resolver for markdown parsing.
    * Also initializes the command line arguments. 
    */
   Docgen(ArgResults argResults) {  
     if (argResults['output-format'] == null) {
       outputToYaml = 
           (argResults['yaml'] == false && argResults['json'] == false) ?
               true : argResults['yaml'];
     } else {
       if ((argResults['output-format'] == 'yaml' && 
           argResults['json'] == true) || 
           (argResults['output-format'] == 'json' && 
           argResults['yaml'] == true)) {
         throw new UnsupportedError('Cannot have contradictory output flags.');
       }
       outputToYaml = argResults['output-format'] == 'yaml' ? true : false;
     }
     outputToJson = !outputToYaml;
     includePrivate = argResults['include-private'];
-    includeSdk = argResults['include-sdk'];
+    parseSdk = argResults['parse-sdk'];
+    includeSdk = parseSdk == true ? true : argResults['include-sdk'];

[Andrei Mouravski, 2013/06/26 04:42:11]

Simply do = parseSdk || arg...

     
     this.linkResolver = (name) => 
         fixReference(name, _currentLibrary, _currentClass, _currentMember);
     
     analyze(argResults.rest);
   }
   
   List<String> listLibraries(List<String> args) {
     // TODO(janicejl): At the moment, only have support to have either one file,
     // or one directory. This is because there can only be one package directory
@@ skipping 15 matching lines @@
   List<String> listDartFromDir(String args) {
     var files = listDir(args, recursive: true);
     packageDir = files.firstWhere((f) => 
         f.endsWith('/pubspec.yaml'), orElse: () => '');
     if (packageDir != '') packageDir = path.dirname(packageDir) + '/packages';
     return files.where((f) => 
         f.endsWith('.dart') && !f.contains('/packages')).toList()
         ..forEach((lib) => logger.info('Added to libraries: $lib'));
   }
 
+  List<String> listSdk() {
+    var sdk = new List<String>();
+    LIBRARIES.forEach((String name, LibraryInfo info) {
+      if (info.documented) { 
+        sdk.add('dart:$name');
+        logger.info('Add to SDK: ${sdk.last}');
+      }
+    });
+    return sdk;
+  }
+  
   /**
    * Analyzes set of libraries by getting a mirror system and triggers the 
    * documentation of the libraries. 
    */
   void analyze(List<String> args) {
-    var libraries = listLibraries(args);
+    var libraries = parseSdk == false ? listLibraries(args) : listSdk();

[Andrei Mouravski, 2013/06/26 04:42:11]

Same as above.

     if (libraries.isEmpty) throw new StateError('No Libraries.');
     // DART_SDK should be set to the root of the SDK library. 
     var sdkRoot = Platform.environment['DART_SDK'];
     if (sdkRoot != null) {
       logger.info('Using DART_SDK to find SDK at $sdkRoot');
     } else {
       // If DART_SDK is not defined in the environment, 
       // assuming the dart executable is from the Dart SDK folder inside bin. 
       sdkRoot = path.dirname(path.dirname(new Options().executable));
       logger.info('SDK Root: ${sdkRoot}');
@@ skipping 357 matching lines @@
   if (!dir.existsSync()) {
     dir.createSync();
   }
   File file = new File('docs/$filename');
   if (!file.existsSync()) {
     file.createSync();
   }
   file.openSync();
   file.writeAsString(text);
 }