Generate docgen output along with api_docs as part of the build

pkg/docgen/bin/docgen.dart

Index: pkg/docgen/bin/docgen.dart
diff --git a/pkg/docgen/bin/docgen.dart b/pkg/docgen/bin/docgen.dart
index cb045378ef144b675a28fd6604519e6fee4aa8f7..a213ff5d4aa91a4d39ebd6410a91bce8426f8b50 100644
--- a/pkg/docgen/bin/docgen.dart
+++ b/pkg/docgen/bin/docgen.dart
@@ -10,6 +10,8 @@ import 'package:logging/logging.dart';
 import '../lib/docgen.dart';
 import 'package:path/path.dart' as path;
 
+List<String> excludedLibraries = [];
+
 /**
  * Analyzes Dart files and generates a representation of included libraries,
  * classes, and members.
@@ -18,15 +20,20 @@ void main(List<String> arguments) {
   logger.onRecord.listen((record) => print(record.message));
   var results = _initArgParser().parse(arguments);
 
+  var includeSdk = results['parse-sdk'] || results['include-sdk'];
+  var introFile = path.join(path.dirname(Platform.script.toFilePath()),
+      'sdk-introduction.md');

[kustermann, 2013/11/18 09:57:08]

Why is this markup file in the docgen/bin directory?

[Alan Knight, 2013/11/18 20:34:50]

I suspect so it was easy to find for bin/docgen.dart. But it doesn't make much
sense. Created a "doc" directory and moved it there.

+  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: results['parse-sdk'] || results['include-sdk'],
+      includeSdk: includeSdk,
       parseSdk: results['parse-sdk'],
-      append: results['append'] && new Directory('docs').existsSync(),
-      introduction: (results['parse-sdk'] || results['include-sdk']) ?
-          'sdk-introduction.md' : results['introduction']);
+      append: results['append'] && new Directory(results['out']).existsSync(),
+      introduction: introduction,
+      out: results['out'],
+      excludeLibraries: excludedLibraries);
 }
 
 /**
@@ -69,6 +76,12 @@ ArgParser _initArgParser() {
   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));
   return parser;
 }