Hack together a quick doc generator for IDL files.

Hack together a quick doc generator for IDL files.
- Changed the IDL parser to mine the Comment nodes, and process them for
parameter comments.
- Added hacks to the doc builder to parse the IDL files and spit out a
generated JSON file before running the generator.

BUG=no
TEST=no

Committed: https://src.chromium.org/viewvc/chrome?view=rev&revision=132474

[asargent_no_longer_on_chrome, 2012-04-16 17:34:11]

LGTM, thanks for doing this.

http://codereview.chromium.org/10082038/diff/1/tools/json_schema_compiler/idl...
File tools/json_schema_compiler/idl_schema.py (right):

http://codereview.chromium.org/10082038/diff/1/tools/json_schema_compiler/idl...
tools/json_schema_compiler/idl_schema.py:29: '': "The processed comment, minus
all |parameter| mentions.",
nit: using the empty string as a key makes the code a little hard to read. Can
you use something like 'SUMMARY' or 'OVERVIEW' or '_SUMMARY_' instead?

[Matt Perry, 2012-04-16 19:19:15]

http://codereview.chromium.org/10082038/diff/1/tools/json_schema_compiler/idl...
File tools/json_schema_compiler/idl_schema.py (right):

http://codereview.chromium.org/10082038/diff/1/tools/json_schema_compiler/idl...
tools/json_schema_compiler/idl_schema.py:29: '': "The processed comment, minus
all |parameter| mentions.",
On 2012/04/16 17:34:11, Antony Sargent wrote:
> nit: using the empty string as a key makes the code a little hard to read. Can
> you use something like 'SUMMARY' or 'OVERVIEW' or '_SUMMARY_' instead?

I had it return a tuple of (summary_comment, parsed_comments) instead.