Allow "internal" APIs to be specified in extension API schemas.

chrome/common/extensions/docs/js/api_page_generator.js

 // 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.
 
 /**
  * @fileoverview This file is the controller for generating extension
  * doc pages.
  *
  * It expects to have available via XHR (relative path):
  *   1) API_TEMPLATE which is the main template for the api pages.
@@ skipping 242 matching lines @@
   } catch(e) {
     console.log('ex: ' + e);
     console.error('exception: ' + e);
     handleError();
   }
 }
 
 function renderTemplate() {
   schema.forEach(function(mod) {
     if (mod.namespace == pageBase) {
-      // Do not render page for modules which are marked as "nodoc": true.
-      if (mod.nodoc) {
+      // Do not render page for modules which have documentation disabled.
+      if (disableDocs(mod))
         return;
-      }
       // This page is an api page. Setup types and apiDefinition.
       module = mod;
       apiModuleName = API_MODULE_PREFIX + module.namespace;
       pageData.apiDefinition = module;
     }
 
     if (mod.types) {
       mod.types.forEach(function(type) {
         typeModule[type.id] = mod;
       });
@@ skipping 141 matching lines @@
 }
 
 /*
  * Template Callout Functions
  * The jstProcess() will call out to these functions from within the page
  * template
  */
 
 function stableAPIs() {
   return schema.filter(function(module) {
-    return !module.nodoc && module.namespace.indexOf('experimental') < 0;
+    return !disableDocs(module) &&
+           module.namespace.indexOf('experimental') < 0;
   }).map(function(module) {
     return module.namespace;
   }).sort();
 }
 
 function experimentalAPIs() {
   return schema.filter(function(module) {
-    return !module.nodoc && module.namespace.indexOf('experimental') == 0;
+    return !disableDocs(module) &&
+           module.namespace.indexOf('experimental') == 0;
   }).map(function(module) {
     return module.namespace;
   }).sort();
-}
-
-function devtoolsAPIs() {
-  return schema.filter(function(module) {
-    return !module.nodoc && module.namespace.indexOf('devtools.') === 0;
-  }).map(function(module) {
-    return module.namespace;
-  }).sort();
 }
 
 function getDataFromPageHTML(id) {
   var node = document.getElementById(id);
   if (!node)
     return;
   return node.innerHTML;
 }
 
 function isArray(type) {
@@ skipping 138 matching lines @@
 }
 
 function getPropertyListFromObject(object) {
   var propertyList = [];
   var properties = object.properties;
   if (!properties && object.type === 'array' && object.items) {
     properties = object.items.properties;
   }
   for (var p in properties) {
     var prop = properties[p];
-    // Do not render properties marked as "nodoc": true.
-    if (prop.nodoc) {
+    // Do not render properties with documentation disabled.
+    if (disableDocs(prop)) {
       continue;
     }
     prop.name = p;
     propertyList.push(prop);
   }
   return propertyList;
 }
 
 function getTypeName(schema) {
   if (schema.$ref)
@@ skipping 47 matching lines @@
 
 function sortByName(a, b) {
   if (a.name < b.name) {
     return -1;
   }
   if (a.name > b.name) {
     return 1;
   }
   return 0;
 }
+
+function disableDocs(obj) {
+  return !!obj.nodoc || !!obj.internal;
+}