Add descriptions to all extension/app schemas, and enforce that they have them

from now on.

BUG=233968
R=kalman@chromium.org
TBR=yoz@chromium.org

Review URL: https://chromiumcodereview.appspot.com/16876004

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@208110 0039d316-1c4b-4281-b951-d872f2087c98

8 files changed, 15 insertions, 7 deletions

diff --git a/tools/json_schema_compiler/dart_test/dictionaries.idl b/tools/json_schema_compiler/dart_test/dictionaries.idl
index 4b26684..1eb9e25 100644
--- a/tools/json_schema_compiler/dart_test/dictionaries.idl
+++ b/tools/json_schema_compiler/dart_test/dictionaries.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// This comment is for the dictionaries namespace.
 namespace dictionaries {
   // Documentation for ComplexType.
   dictionary InnerType {
diff --git a/tools/json_schema_compiler/dart_test/empty_namespace.idl b/tools/json_schema_compiler/dart_test/empty_namespace.idl
index 5a5ea03..824de2d 100644
--- a/tools/json_schema_compiler/dart_test/empty_namespace.idl
+++ b/tools/json_schema_compiler/dart_test/empty_namespace.idl
@@ -2,5 +2,6 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// An empty comment is required for an empty namespace.
 namespace empty_namespace {
 };
diff --git a/tools/json_schema_compiler/dart_test/empty_type.idl b/tools/json_schema_compiler/dart_test/empty_type.idl
index af5de84..9d7de6f 100644
--- a/tools/json_schema_compiler/dart_test/empty_type.idl
+++ b/tools/json_schema_compiler/dart_test/empty_type.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// Namespace-level comment for EmptyType.
 namespace empty_type {
   // Documentation for EmptyType.
   dictionary EmptyType {
diff --git a/tools/json_schema_compiler/dart_test/enums.idl b/tools/json_schema_compiler/dart_test/enums.idl
index 18ea85a..1c82d00 100644
--- a/tools/json_schema_compiler/dart_test/enums.idl
+++ b/tools/json_schema_compiler/dart_test/enums.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// A comment for the enums namespace.
 namespace enums {
   // A basic enumeration.
   enum Enum1 { a, b };
diff --git a/tools/json_schema_compiler/dart_test/events.idl b/tools/json_schema_compiler/dart_test/events.idl
index 54c711a..f1fb4b6 100644
--- a/tools/json_schema_compiler/dart_test/events.idl
+++ b/tools/json_schema_compiler/dart_test/events.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// This comment is for the events namespace.
 namespace events {
   dictionary EventArgumentElement {
     DOMString elementStringArg;
diff --git a/tools/json_schema_compiler/dart_test/functions.idl b/tools/json_schema_compiler/dart_test/functions.idl
index e2283c6..e303d0d 100644
--- a/tools/json_schema_compiler/dart_test/functions.idl
+++ b/tools/json_schema_compiler/dart_test/functions.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// A comment for the functions namespace.
 namespace functions {
   callback SimpleCallback = void ();
 
diff --git a/tools/json_schema_compiler/dart_test/operatable_type.idl b/tools/json_schema_compiler/dart_test/operatable_type.idl
index 74ce534..9c5f53c 100644
--- a/tools/json_schema_compiler/dart_test/operatable_type.idl
+++ b/tools/json_schema_compiler/dart_test/operatable_type.idl
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// Top-level namespace-comment for operatableType
 namespace operatable_type {
   dictionary DictType {
     int x;
@@ -28,4 +29,4 @@ namespace operatable_type {
     // Function taking dict type.
     static void dictArgFunc(DictType d);
   };
-};
\ No newline at end of file
+};
diff --git a/tools/json_schema_compiler/dart_test/tags.idl b/tools/json_schema_compiler/dart_test/tags.idl
index f4ddff4..7a029cd 100644
--- a/tools/json_schema_compiler/dart_test/tags.idl
+++ b/tools/json_schema_compiler/dart_test/tags.idl
@@ -2,30 +2,31 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+// A comment describing tags.
 namespace tags {
   // This dictionary has the property [inline_doc].
   [inline_doc] dictionary InlineDoc {
   };
-  
+
   // This dictionary has the property [nodoc].
   [nodoc] dictionary Nodoc {
   };
-  
+
   // This dictionary has the property [nocompile].
   [nocompile] dictionary Nocompile {
   };
-  
+
   // This dictionary has no tags on the dictionary itself.
   dictionary PlainDict {
     // This int has the property [inline_doc].
     [inline_doc] int inline_doc;
-    
+
     // This String has the property [nodoc].
     [nodoc] String nodoc;
-    
+
     // This double has the property [nocompile].
     [nocompile] double nocompile;
-    
+
     // This object has the property [instanceOf=fileEntry].
     [instanceOf=fileEntry] object instance_of_tag;
   };