Adds a --include-dependent-packages option to docgen

pkg/docgen/bin/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.
 
 import 'dart:io';
 
 import 'package:args/args.dart';
 import 'package:logging/logging.dart';
 
 import '../lib/docgen.dart';
@@ skipping 16 matching lines @@
   var introduction = includeSdk ? introFile : results['introduction'];
   docgen(results.rest.map(path.normalize).toList(),
       packageRoot: results['package-root'],
       outputToYaml: !results['json'],
       includePrivate: results['include-private'],
       includeSdk: includeSdk,
       parseSdk: results['parse-sdk'],
       append: results['append'] && new Directory(results['out']).existsSync(),
       introduction: introduction,
       out: results['out'],
-      excludeLibraries: excludedLibraries);
+      excludeLibraries: excludedLibraries,
+      includeDependentPackages: results['include-dependent-packages']);
 }
 
 /**
  * Creates parser for docgen command line arguments.
  */
 ArgParser _initArgParser() {
   var parser = new ArgParser();
   parser.addFlag('help', abbr: 'h',
       help: 'Prints help and usage information.',
       negatable: false,
@@ skipping 29 matching lines @@
   parser.addOption('introduction',
       help: 'Adds the provided markdown text file as the introduction'
         ' for the outputted documentation.', defaultsTo: '');
   parser.addOption('out',
       help: 'The name of the output directory.',
       defaultsTo: 'docs');
   parser.addOption('exclude-lib',
       help: 'Exclude the library by this name from the documentation',
       allowMultiple: true,
       callback: (libs) => excludedLibraries.addAll(libs));
+  parser.addFlag('include-dependent-packages',
+      help: 'Assumes we are documenting a single package and are running '
+        'in the directory with its pubspec. Includes documentation for all '
+        'of its dependent packages.',
+      defaultsTo: false, negatable: false);
   return parser;
 }