Change the --include-external flag to be more selective (#1289)

Author: keertip

CHANGELOG.md

@@ -1,3 +1,7 @@
+## unreleased
+* change the `--include-external` flag to help disambiguate files to 
+  include (#1236)
+
 ## 0.9.8
 * support for generic methods.
 * remove deps on cli_utils and which.

bin/dartdoc.dart

@@ -193,7 +193,9 @@ ArgParser _createArgsParser() {
   parser.addOption('include',
       allowMultiple: true, help: 'library names to generate docs for');
   parser.addOption('include-external',
-      allowMultiple: true, help: 'additional (external) libraries to include');
+      allowMultiple: true,
+      help: 'additional (external) dart files to include, use "dir/fileName", '
+          'as in lib/material.dart');
   parser.addOption('hosted-url',
       help:
           'URL where the docs will be hosted (used to generate the sitemap).');

lib/dartdoc.dart

@@ -252,12 +252,13 @@ class DartDoc {
     while (result.hasMoreWork) {
       result = context.performAnalysisTask();
     }
-
+    
     // Use the includeExternals.
     for (Source source in context.librarySources) {
       LibraryElement library = context.computeLibraryElement(source);
       String libraryName = Library.getLibraryName(library);
-      if (includeExternals.contains(libraryName)) {
+      var fullPath = source.fullName;
+      if (includeExternals.any((string) => fullPath.endsWith(string))) {
         if (libraries.map(Library.getLibraryName).contains(libraryName)) {
           continue;
         }