Split the comment strings in docs extraction on newlines.

tools/dom/scripts/generator.py

 #!/usr/bin/python
 # 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.
 
 """This module provides shared functionality for systems to generate
 Dart APIs from the IDL database."""
 
 import copy
 import json
@@ skipping 814 matching lines @@
   # Add documentation from JSON.
   comments = []
 
   if library_name in _dom_json and interface_name in _dom_json[library_name]:
     if member_name and (member_name in
                         _dom_json[library_name][interface_name]['members']):
       comments = _dom_json[library_name][interface_name]['members'][member_name]
     elif 'comment' in _dom_json[library_name][interface_name]:
       comments = _dom_json[library_name][interface_name]['comment']
 
+  if (len(comments)):

[blois, 2013/01/29 16:53:31]

unnecessary parens, and I believe you can just do:
if comments:

+    comments = ['\n'.join(comments)]
+
   return comments
 
 def GetAnnotationsAndComments(interface_name, member_name=None,
                               library_name=None):
   annotations = GetComments(interface_name, member_name, library_name)
   annotations = annotations + (FindCommonAnnotations(interface_name,
                                                      member_name,
                                                      library_name))
 
   return annotations
@@ skipping 596 matching lines @@
                                   self)
 
     if type_data.clazz == 'SVGTearOff':
       dart_interface_name = self._renamer.RenameInterface(
           self._database.GetInterface(type_name))
       return SVGTearOffIDLTypeInfo(
           type_name, type_data, dart_interface_name, self)
 
     class_name = '%sIDLTypeInfo' % type_data.clazz
     return globals()[class_name](type_name, type_data)