Dartdoc supports package directory.

pkg/dartdoc/bin/dartdoc.dart

 // Copyright (c) 2012, 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.
 
 /**
  * To generate docs for a library, run this script with the path to an
  * entrypoint .dart file, like:
  *
  *     $ dart dartdoc.dart foo.dart
  *
@@ skipping 17 matching lines @@
 main() {
   // Need this because ArgParser.getUsage doesn't show command invocation.
   final USAGE = 'Usage dartdoc [options] <entrypoint(s)>\n[options] include:';
 
   final args = new Options().arguments;
 
   final dartdoc = new Dartdoc();
 
   final argParser = new ArgParser();
 
+  final libPath = scriptDir.append('../../../');

[Lasse Reichstein Nielsen, 2012/09/19 12:06:49]

final what? I'm guessing Path, but please write it here.

[Bob Nystrom, 2012/09/19 16:17:17]

For what it's worth, most of the Dartdoc codebase doesn't annotate local
variables, so this is consistent.

+  Path pkgPath = scriptDir.append('../../../pkg/');
+
   argParser.addFlag('no-code',
       help: 'Do not include source code in the documentation.',
       defaultsTo: false, negatable: false,
       callback: (noCode) => dartdoc.includeSource = !noCode);
 
   argParser.addOption('mode', abbr: 'm',
       help: 'Define how HTML pages are generated.',
       allowed: ['static', 'live-nav'], allowedHelp: {
         'static': 'Generates completely static HTML containing\n'
           'everything you need to browse the docs. The only\n'
@@ skipping 89 matching lines @@
           for(final lst in excLibs) {
             var someLibs = lst.split(',');
             for(final lib in someLibs) {
               allLibs.add(lib);
             }
           }
           dartdoc.excludedLibraries = allLibs;
         }
       }, allowMultiple: true);
 
-  final libPath = scriptDir.append('../../../');
-  dartdoc.dartdocPath = libPath.append('pkg/dartdoc');
+  argParser.addOption('pkg',
+      help: 'Sets the package directory to the specified directory.\n'
+        'If omitted the package directory is the SDK pkg/ dir',
+      callback: (pkgDir) {
+        if(pkgDir != null) {
+          pkgPath = new Path.fromNative(pkgDir);
+        }
+      });
+
+   dartdoc.dartdocPath = libPath.append('pkg/dartdoc');

[Lasse Reichstein Nielsen, 2012/09/19 12:06:49]

bad indent?

[Johnni Winther, 2012/09/20 08:55:59]

Done.

 
   if (args.isEmpty()) {
     print('No arguments provided.');
     print(USAGE);
     print(argParser.getUsage());
     return;
   }
 
   final entrypoints = <Path>[];
   try {
     final option = argParser.parse(args);
     for(final arg in option.rest) {
       entrypoints.add(new Path.fromNative(arg));
     }
   } on FormatException catch (e) {
     print(e.message);
     print(USAGE);
     print(argParser.getUsage());
     return;
   }
 
   if (entrypoints.isEmpty()) {
     print('No entrypoints provided.');
     print(argParser.getUsage());
     return;
   }
 
   cleanOutputDirectory(dartdoc.outputDir);
 
-  dartdoc.documentLibraries(entrypoints, libPath);
+  dartdoc.documentLibraries(entrypoints, libPath, pkgPath);
 
   Future compiled = compileScript(dartdoc.mode, dartdoc.outputDir, libPath);
   Future filesCopied = copyDirectory(scriptDir.append('../static'),
                                      dartdoc.outputDir);
 
   Futures.wait([compiled, filesCopied]).then((_) {
     dartdoc.cleanup();
     print('Documented ${dartdoc.totalLibraries} libraries, '
           '${dartdoc.totalTypes} types, and ${dartdoc.totalMembers} members.');
   });
 }