Docserver: Display enum value descriptions in API docs.

tools/json_schema_compiler/idl_schema.py

 #! /usr/bin/env python
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import itertools
 import json
 import os.path
 import re
 import sys
@@ skipping 274 matching lines @@
   schema compiler expects to see.
   '''
   def __init__(self, enum_node):
     self.node = enum_node
     self.description = ''
 
   def process(self, callbacks):
     enum = []
     for node in self.node.children:
       if node.cls == 'EnumItem':
-        enum.append(node.GetName())
+        enum_value = {'name': node.GetName()}
+        for child in node.children:
+          if child.cls == 'Comment':
+            enum_value['description'] = ProcessComment(child.GetName())[0]
+          else:
+            sys.exit('Did not process %s %s' % (child.cls, child))

[not at google - send to devlin, 2013/10/28 18:00:25]

sys.exit to signal errors!? (aware that other places in the file do this; but
this would be what exceptions are for).

[Sam McNally, 2013/10/29 00:39:02]

Done.

+        enum.append(enum_value)
       elif node.cls == 'Comment':
         self.description = ProcessComment(node.GetName())[0]
       else:
         sys.exit('Did not process %s %s' % (node.cls, node))
     result = {'id' : self.node.GetName(),
               'description': self.description,
               'type': 'string',
               'enum': enum}
     for property_name in ('inline_doc', 'noinline_doc', 'nodoc'):
       if self.node.GetProperty(property_name):
@@ skipping 110 matching lines @@
   Dump a json serialization of parse result for the IDL files whose names
   were passed in on the command line.
   '''
   for filename in sys.argv[1:]:
     schema = Load(filename)
     print json.dumps(schema, indent=2)
 
 
 if __name__ == '__main__':
   Main()