pkg/docgen: removed yaml and append output support

pkg/docgen: removed yaml and append output support

R=efortuna@google.com

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

[kevmoo, 2014-04-14 19:03:32]

Will do a separate CL (with tests) for pretty output

[Emily Fortuna, 2014-04-14 20:53:47]

lgtm

[kevmoo, 2014-04-14 20:56:21]

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

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

Kevin: Sorry to hijack your cl, but it just caught my attention due to:
https://code.google.com/p/dart/issues/detail?id=18392
Just one comma comment for you :-)
Alan: I think this was already here from the beginning on, if I reviewed this
and missed it I apologize

https://codereview.chromium.org/237443004/diff/1/utils/apidoc/docgen.gyp
File utils/apidoc/docgen.gyp (right):

https://codereview.chromium.org/237443004/diff/1/utils/apidoc/docgen.gyp#newc...
utils/apidoc/docgen.gyp:67: '../../tools/only_in_release_mode.py',
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

https://codereview.chromium.org/237443004/diff/1/utils/apidoc/docgen.gyp#newc...
utils/apidoc/docgen.gyp:77: '../../sdk/bin/dart',
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

https://codereview.chromium.org/237443004/diff/1/utils/apidoc/docgen.gyp#newc...
utils/apidoc/docgen.gyp:87: '../../pkg'
it is pretty standard to have trailing commas in lists in python (we and
chromium have it all over our gyp files)