Move chrome.downloads out of experimental to dev

ppapi/generators/idl_parser.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.
 
 """ Parser for PPAPI IDL """
 
 #
 # IDL Parser
 #
@@ skipping 203 matching lines @@
   # in turn are children of the file object created from the results of top.
   def p_top(self, p):
     """top : COMMENT COMMENT ext_attr_block top_list"""
 
     Copyright = self.BuildComment('Copyright', p, 1)
     Filedoc = self.BuildComment('Comment', p, 2)
 
     p[0] = ListFromConcat(Copyright, Filedoc, p[3], p[4])
     if self.parse_debug: DumpReduction('top', p)
 
+  def p_top_short(self, p):
+    """top : COMMENT ext_attr_block top_list"""
+    Copyright = self.BuildComment('Copyright', p, 1)
+    p[0] = ListFromConcat(Copyright, p[2], p[3])

[asargent_no_longer_on_chrome, 2012/06/07 00:18:08]

Unfortunately there are some specific assumptions about the parse tree of some
Pepper API IDL files that I think this change might break. I agree with kalman
that we probably want to keep overview documentation in the .html files and just
use comments in the .idl file for narrow plaintext documentation of specific
functions/parameters/objects. 

[benjhayden, 2012/06/08 16:41:52]

I moved the documentation back into the html file, but there would still be
TODOs in IDL files about this issue if I removed p_top_short().

Note that p_top_short() does not replace p_top(), so ppapi IDLs can continue to
use and rely on filedocs.

Do I really need to remove p_top_short()? If so, can you elaborate?

+    if self.parse_debug: DumpReduction('top', p)
+
   # Build a list of top level items.
   def p_top_list(self, p):
     """top_list : callback_decl top_list
                 | describe_block top_list
                 | dictionary_block top_list
                 | enum_block top_list
                 | inline top_list
                 | interface_block top_list
                 | label_block top_list
                 | namespace top_list
@@ skipping 260 matching lines @@
   def p_expression_symbol(self, p):
     "expression : SYMBOL"
     p[0] = p[1]
     if self.parse_debug: DumpReduction('expression_symbol', p)
 
   def p_expression_integer(self, p):
     "expression : integer"
     p[0] = p[1]
     if self.parse_debug: DumpReduction('expression_integer', p)
 
+  def p_expression_float(self, p):
+    "expression : FLOAT"
+    p[0] = p[1]
+    if self.parse_debug: DumpReduction('expression_float', p)
+
 #
 # Array List
 #
 # Defined a list of array sizes (if any).
 #
   def p_arrays(self, p):
     """arrays : '[' ']' arrays
               | '[' integer ']' arrays
               | """
     # If there are 3 tokens plus a return slot it is an unsized array
@@ skipping 603 matching lines @@
   ast = ParseFiles(filenames)
   errs = ast.GetProperty('ERRORS')
   if errs:
     ErrOut.Log('Found %d error(s).' % errs);
   InfoOut.Log("%d files processed." % len(filenames))
   return errs
 
 
 if __name__ == '__main__':
   sys.exit(Main(sys.argv[1:]))