Move documentScan.html from extensions to apps

chrome/common/extensions/api/document_scan.idl

Index: chrome/common/extensions/api/document_scan.idl
diff --git a/chrome/common/extensions/api/document_scan.idl b/chrome/common/extensions/api/document_scan.idl
index 0428d4a10b0481ad0d84cb853dcf50aef0d76576..000c2342cef43ba1b677bbb550e06462b11b526e 100644
--- a/chrome/common/extensions/api/document_scan.idl
+++ b/chrome/common/extensions/api/document_scan.idl
@@ -18,18 +18,18 @@ namespace documentScan {
     // 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);
   };