Move documentScan.html from extensions to apps

chrome/common/extensions/api/document_scan.idl

 // Copyright 2014 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.
 
 // Use the <code>chrome.document_scan</code> API to discover and retrieve
 // images from attached paper document scanners.
 namespace documentScan {
   dictionary ScanOptions {
     // The MIME types that are accepted by the caller.
     DOMString[]? mimeTypes;
 
     // The number of scanned images allowed (defaults to 1).
     long? maxImages;
   };
 
   dictionary ScanResults {
     // The data image URLs in a form that can be passed as the "src" value to
     // an image tag.
     DOMString[] dataUrls;
 
-    // The MIME type of |dataUrls|.
+    // The MIME type of <code>dataUrls</code>.
     DOMString mimeType;
   };
 
   // Callback from the <code>scan</code> method; on success
   // the results from the scan is returned in |results|.

[not at google - send to devlin, 2015/02/03 18:22:17]

2 things: "results" was fine, but also, this will need to <code>results</code>.

However, try this:

// Callback from the <code>scan</code> method.
// |results| The results from the scan, if successful.
// Otherwise, will return [what? empty results? null] and set
// runtime.lastError.

see how it renders (chrome/common/extensions/docs/server2/preview.py). I can't
remember what it will look like.

[Paul Stewart, 2015/02/03 21:43:12]

I'm trying to satisfy commentary I'm getting in parallel from
http://crbug.com/450601 .  Feel free to intervene in that discussion if you feel
strongly.
Done.  Makes no difference due to how the comments are generated for inlines.

-  callback ScanCallback = void (ScanResults results);
+  callback ScanCallback = void (ScanResults result);
 
   interface Functions {
     // Performs a document scan.  On success, the PNG data will be
     // sent to the callback.
-    // |options| : <code>Options</code> object containing scan parameters.
+    // |options| : Object containing scan parameters.
     // |callback| : Called with the result and data from the scan.
     static void scan(ScanOptions options, ScanCallback callback);
   };
 };