Refactor scripts, so we have a single entrypoint, dartdoc.py, to generate docs.

Refactor scripts, so we have a single entrypoint, dartdoc.py, to generate docs.

Also, generate documentation incrementally as a fallback so that some docs are
generated rather than an all-or-nothing approach.

Also, set a "blacklist" instead of a "whitelist" for annotations.

BUG=
R=alanknight@google.com

Committed: https://code.google.com/p/dart/source/detail?r=29780

[Emily Fortuna, 2013-11-01 22:34:46]

https://codereview.chromium.org/56183003/diff/70001/pkg/docgen/bin/dartdoc.py
File pkg/docgen/bin/dartdoc.py (right):

https://codereview.chromium.org/56183003/diff/70001/pkg/docgen/bin/dartdoc.py...
pkg/docgen/bin/dartdoc.py:10: import optparse
argparse was introduced in Python 2.7, and if this gets run on a bot, the bots
only have 2.6. optparse is the alternative.

https://codereview.chromium.org/56183003/diff/70001/pkg/docgen/lib/docgen.dart
File pkg/docgen/lib/docgen.dart (right):

https://codereview.chromium.org/56183003/diff/70001/pkg/docgen/lib/docgen.dar...
pkg/docgen/lib/docgen.dart:5: /// **docgen** is a tool for creating machine
readable representations of Dart
there was a mixture of /// and /** throughout this file. I made them all
consistent.

[Alan Knight, 2013-11-01 23:10:42]

Awesome! LGTM

[Emily Fortuna, 2013-11-01 23:18:40]

Committed patchset #1 manually as r29780 (presubmit successful).