docgen always produces dart:core

[tekz omnisoft]

This has been an ongoing problem and for others reported on StackOverflow.  For some reason docgen always creates dart:core regardless of defaults or options selected.

Issue 20573: Default --include-sdk to OFF for docgen is marked fixed but the problem for me still exists running 

Editor: 1.8.0.dev_00_00 (2014-10-16) 

cmd /c docgen.bat --verbose ^

--serve ^

--no-include-sdk ^

--no-include-dependent-packages ^

--out %PATH-DARTDOCS-MOWBOT% ^

--package-root=%PATH-PROJECT%\packages ^

--exclude-lib="dart-core" ^

%PROJECTLIBS%

Even if I specify options --no-include-sdk & --exclude-lib="dart-core", dart:core is generated.  Worse yet, it displays as the default start page.  I have to select menu option "Show Packages" to reveal my project's libraries.  Is this the intended behavior, or my setup is incorrect?

[Alan Knight]

It's certainly not the intended behaviour, and it's not what I see if I run docgen on a package. 

The --start-page option will let you control where it starts, but that should be set automatically if you run it on the root of a package. But if PROJECTLIBS isn't a directory with a pubspec in it, then it won't think it's documenting a package, so you might need that.

You will likely get parts of dart:core generated, because even if a library is not included, if there are references to classes in a dependency it will generate the data for that class. But it shouldn't be the whole thing and it shouldn't start there.

--
For other discussions, see https://groups.google.com/a/dartlang.org/
 
For HOWTO questions, visit http://stackoverflow.com/tags/dart
 
To file a bug report or feature request, go to http://www.dartbug.com/new

To unsubscribe from this group and stop receiving emails from it, send an email to misc+uns...@dartlang.org.