chore(documentation-generation): prepare for transition from dartdoc to docgen

scripts/env.sh

@@ -29,7 +29,7 @@ export DART=${DART:-"$DARTSDK/bin/dart"}
 export PUB=${PUB:-"$DARTSDK/bin/pub"}
 export DARTANALYZER=${DARTANALYZER:-"$DARTSDK/bin/dartanalyzer"}
 export DARTDOC=${DARTDOC:-"$DARTSDK/bin/dartdoc"}
-
+export DART_DOCGEN=${DART_DOCGEN:-"$DARTSDK/bin/docgen"}
 
 export CHROME_CANARY_BIN=${CHROME_CANARY_BIN:-"$DARTIUM"}
 export CHROME_BIN=${CHROME_BIN:-"google-chrome"}

scripts/generate-documentation.sh

@@ -1,8 +1,28 @@
 #!/bin/bash
 . $(dirname $0)/env.sh
-$DARTDOC \
+
+# Temporary during transition period from use of dartdoc to docgen.
+if [ -x "$DART_DOCGEN" ]; then
+    # docgen seems to freeze when it processes the angular.dart files
+    # https://code.google.com/p/dart/issues/detail?id=16752
+    # so disable it for now
+    # DOC_CMD="$DART_DOCGEN"
+    # MODE_OPTION=
+    echo "DISABLING DOCUMENT GENERATION due to isses with docgen."
+    echo "https://code.google.com/p/dart/issues/detail?id=16752"
+    echo "----"
+    echo "Reporting success none-the-less during this docgen beta period."
+    exit 0;
+elif [ -x "$DARTDOC" ]; then
+    DOC_CMD="$DARTDOC"
+    MODE_OPTION="--mode=static"
+fi
+
+echo "Generating documentation using $DOC_CMD"
+"$DOC_CMD" $MODE_OPTION \
     --package-root=packages/ \
     --out doc \
-    --mode=static \
     --exclude-lib=js,metadata,meta,mirrors,intl,number_symbols,number_symbol_data,intl_helpers,date_format_internal,date_symbols,angular.util \
-    packages/angular/angular.dart lib/mock/module.dart \
+    packages/angular/angular.dart lib/mock/module.dart
+
+