pkg/docgen: removed yaml and append output support

utils/apidoc/docgen.gyp

 # 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.
 
 {
   'variables' : {
     'script_suffix%': '',
   },
   'conditions' : [
     ['OS=="win"', {
@@ skipping 46 matching lines @@
             '<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)dart<(EXECUTABLE_SUFFIX)',
             '<(SHARED_INTERMEDIATE_DIR)/utils_wrapper.dart.snapshot',
             '<!@(["python", "../../tools/list_files.py", "\\.(css|ico|js|json|png|sh|txt|yaml|py)$", ".", "../../sdk/lib/_internal/dartdoc"])',
             '<!@(["python", "../../tools/list_files.py", "\\.dart$", ".", "../../sdk/lib", "../../runtime/lib", "../../runtime/bin"])',
             '../../sdk/bin/dart',
             '../../sdk/bin/dart.bat',
             '../../sdk/bin/dart2js',
             '../../sdk/bin/dart2js.bat',
             '../../sdk/bin/docgen',
             '../../sdk/bin/docgen.bat',
             '../../tools/only_in_release_mode.py',

[ricow1, 2014/04/23 07:16:07]

it seems that we are using ../../pkg below as an argument to docgen, if we are
actually using ../../pkg we should have the files as input here. You can either
do that by doing list_files.py on ../../pkg or better, since you will only have
one more file, many inputs can mess up xcodebuild on mac: add a dependency on
../../pkg/pkg_files.gyp:pkg_files_stamp and in input have 
'<(SHARED_INTERMEDIATE_DIR)/pkg_files.stamp',

It may be that we have this "dependency implicitly through another
dependency/input - but we should not rely on it

           ],
           'outputs': [
             '<(PRODUCT_DIR)/api_docs/docgen/index.json',
           ],
           'action': [
             'python',
             '../../tools/only_in_release_mode.py',
             '<@(_outputs)',
             '--',
             '../../sdk/bin/dart',

[ricow1, 2014/04/23 07:16:07]

Here you should use:
 '<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)dart<(EXECUTABLE_SUFFIX)',
since you are depending on this in the inputs list
also, using that line will fix
https://code.google.com/p/dart/issues/detail?id=18392

             '--package-root=<(PRODUCT_DIR)/packages',
             '../../pkg/docgen/bin/docgen.dart',
             '--out=<(PRODUCT_DIR)/api_docs/docgen',
-            '--json',
             '--include-sdk',
             '--no-include-dependent-packages',
             '--package-root=<(PRODUCT_DIR)/packages',
             '--exclude-lib=async_helper',
             '--exclude-lib=expect',
             '--exclude-lib=docgen',
-            '../../pkg',          
+            '../../pkg'

[ricow1, 2014/04/23 07:16:07]

it is pretty standard to have trailing commas in lists in python (we and
chromium have it all over our gyp files)

           ],
           'message': 'Running docgen: <(_action)',
         },
       ],
     }
   ],
 }