HTML human writable docs working end to end!... mostly...

sdk/lib/html/scripts/dartdomgenerator.py

 #!/usr/bin/python
 # Copyright (c) 2011, 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.
 
 """This is the entry point to create Dart APIs from the IDL database."""
 
 import dartgenerator
 import database
 import fremontcutbuilder
@@ skipping 67 matching lines @@
         emitters, dart_output_dir, dart_libraries)
     event_generator = HtmlEventGenerator(webkit_database, template_loader)
 
     def generate_interface(interface):
       backend = backend_factory(interface)
       interface_generator = HtmlDartInterfaceGenerator(
           options, dart_library_emitter, event_generator, interface, backend)
       interface_generator.Generate()
 
     generator.Generate(webkit_database, common_database, generate_interface)
+
     dart_library_emitter.EmitLibraries(auxiliary_dir)
 
   if dart2js_output_dir:
     template_paths = ['html/dart2js', 'html/impl', 'html/interface', '']
     template_loader = TemplateLoader(template_dir,
                                      template_paths,
                                      {'DARTIUM': False, 'DART2JS': True})
     backend_options = GeneratorOptions(
         template_loader, webkit_database, type_registry, renamer)
     backend_factory = lambda interface:\
@@ skipping 26 matching lines @@
                  template_loader, backend_factory)
     cpp_library_emitter.EmitDerivedSources(
         template_loader.Load('cpp_derived_sources.template'),
         dartium_output_dir)
     cpp_library_emitter.EmitResolver(
         template_loader.Load('cpp_resolver.template'), dartium_output_dir)
 
   _logger.info('Flush...')
   emitters.Flush()
 
-def GenerateSingleFile(library_path, output_dir):
+def GenerateSingleFile(library_path, output_dir, generated_output_dir=None):
   library_dir = os.path.dirname(library_path)
   library_filename = os.path.basename(library_path)
   copy_dart_script = os.path.relpath('../../../../tools/copy_dart.py',
       library_dir)
   output_dir = os.path.relpath(output_dir, library_dir)
   command = ' '.join(['cd', library_dir, ';',
                       copy_dart_script, output_dir, library_filename])
   subprocess.call([command], shell=True)
 
 def main():
@@ skipping 18 matching lines @@
                     help='''Use the cached database from the previous run to
                     improve startup performance''')
   (options, args) = parser.parse_args()
 
   current_dir = os.path.dirname(__file__)
   database_dir = os.path.join(current_dir, '..', 'database')
   logging.config.fileConfig(os.path.join(current_dir, 'logging.conf'))
   systems = options.systems.split(',')
 
   output_dir = options.output_dir or os.path.join(current_dir, '../generated')
+
   dart2js_output_dir = None
   if 'htmldart2js' in systems:
     dart2js_output_dir = os.path.join(output_dir, 'dart2js')
   dartium_output_dir = None
   if 'htmldartium' in systems:
     dartium_output_dir = os.path.join(output_dir, 'dartium')
 
   if options.rebuild:
     # Parse the IDL and create the database.
     database = fremontcutbuilder.main(options.parallel)
   else:
     # Load the previously generated database.
     database = LoadDatabase(database_dir, options.use_database_cache)
   GenerateFromDatabase(database, dart2js_output_dir, dartium_output_dir)
 
+  _logger.info('Add documentation to generated classes.')
+  html_to_json_script = os.path.relpath(
+      '../../../../tools/html_json_doc/bin/html_json_doc.dart',
+      current_dir)
+  html_output_dir = os.path.join(output_dir, 'dart2js/dart/html/')
+  svg_output_dir = os.path.join(output_dir, 'dart2js/dart/svg/')
+  html_json_path = os.path.relpath('../docs/html_docs.json')
+  svg_json_path = os.path.relpath('../docs/svg_docs.json')
+  html_command = ' '.join(['dart', html_to_json_script, '--mode=json-to-html',
+                      html_output_dir, html_json_path])
+  svg_command = ' '.join(['dart', html_to_json_script, '--mode=json-to-html',
+                      svg_output_dir, svg_json_path])
+  subprocess.call([html_command], shell=True)
+  subprocess.call([svg_command], shell=True)
+
   if 'htmldart2js' in systems:
     _logger.info('Generating dart2js single files.')
     GenerateSingleFile(os.path.join(dart2js_output_dir, 'html_dart2js.dart'),
                        '../dart2js')
     GenerateSingleFile(os.path.join(dart2js_output_dir, 'svg_dart2js.dart'),
         '../../svg/dart2js')
   if 'htmldartium' in systems:
     _logger.info('Generating dartium single files.')
     GenerateSingleFile(os.path.join(dartium_output_dir, 'html_dartium.dart'),
                        '../dartium')
     GenerateSingleFile(os.path.join(dartium_output_dir, 'svg_dartium.dart'),
         '../../svg/dartium')
 
 if __name__ == '__main__':
   sys.exit(main())