Fix some typos, broken links and other issues in extension docs

chrome/common/extensions/api/downloads.idl

Index: chrome/common/extensions/api/downloads.idl
===================================================================
--- chrome/common/extensions/api/downloads.idl	(revision 181647)
+++ chrome/common/extensions/api/downloads.idl	(working copy)
@@ -191,8 +191,7 @@
     // with a hyphen: '-startTime'.
     DOMString? orderBy;
 
-    // The <code>id</code> of the $ref:DownloadItem
-    // that changed.
+    // An identifier that is persistent across browser sessions.

[Mike West, 2013/02/11 08:21:53]

+rdsmith: I don't know this API wll enough to know which of these is which. :)

[方觉(Fang Jue), 2013/02/11 11:37:54]

I just provide some context. DownloadQuery is used in the search method to
search for download items, which has nothing to do with changes in a download
item. DownloadDelta is used in the onChanged event, which does describe changes
in a download item.
Waiting for Randy's opinion :)

     long? id;
 
     // Absolute URL.
@@ -259,7 +258,8 @@
 
   // Encapsulates a change in a DownloadItem.
   [inline_doc] dictionary DownloadDelta {
-    // An identifier that is persistent across browser sessions.
+    // The <code>id</code> of the $ref:DownloadItem
+    // that changed.
     long id;
 
     // The change in <code>url</code>, if any.