Inline docs render properly in extensions doc server.

chrome/common/extensions/api/downloads.idl

Index: chrome/common/extensions/api/downloads.idl
diff --git a/chrome/common/extensions/api/downloads.idl b/chrome/common/extensions/api/downloads.idl
index d857f803ce59906adb6f664970cf983df82ab5e2..b0a850c7b74bbe3aa3aa91974efbde49b67ea2cf 100644
--- a/chrome/common/extensions/api/downloads.idl
+++ b/chrome/common/extensions/api/downloads.idl
@@ -22,9 +22,9 @@ namespace downloads {
   // </dl>
   [inline_doc] enum FilenameConflictAction {uniquify, overwrite, prompt};
 
-  // $ref:onDeterminingFilename listeners may pass a $ref:FilenameSuggestion
-  // object to <code>suggest()</code> in order to override a download's target
-  // filename.
+  // $ref:onDeterminingFilename listeners may pass a
+  // <code>FilenameSuggestion</code> object to <code>suggest()</code> in order
+  // to override a download's target filename.
   [inline_doc] dictionary FilenameSuggestion {

[not at google - send to devlin, 2013/04/24 19:36:11]

let's just remove the [inline_doc] from here, it looks like a bug, since these
<code>FilenameSuggestion</code> references don't make sense without the type
being defined.

benjhayden: wdyt?

[benjhayden, 2013/04/24 20:09:47]

http://chrome-apps-doc2.appspot.com/trunk/extensions/downloads.html

Counter-offer:
 * keep it [inline_doc].
 * Remove the comment above 'dictionary FilenameSuggestion {' which is not
displayed.
 * Change all <code>FilenameSuggestion</code> to <code>suggestion</code>.
 * Change <code>FilenameSuggestion.filename</code> to just
<code>filename</code>.

wdyt?

     // The $ref:DownloadItem's new target $ref:DownloadItem.filename, as a path
     // relative to the user's default Downloads directory, possibly containing
@@ -32,7 +32,8 @@ namespace downloads {
     // back-references ".." will be ignored.
     DOMString filename;
 
-    // The action to take if $ref:FilenameSuggestion.filename already exists.
+    // The action to take if <code>FilenameSuggestion.filename</code> already
+    // exists.
     FilenameConflictAction? conflict_action;
   };
 
@@ -465,15 +466,15 @@ namespace downloads {
     // until all listeners have called <code>suggest</code>. Listeners may call
     // <code>suggest</code> without any arguments in order to allow the download
     // to use <code>downloadItem.filename</code> for its filename, or pass a
-    // $ref:FilenameSuggestion object to <code>suggest</code> in order to
-    // override the target filename. If more than one extension overrides the
+    // <code>FilenameSuggestion</code> object to <code>suggest</code> in order
+    // to override the target filename. If more than one extension overrides the
     // filename, then the last extension installed whose listener passes a
-    // $ref:FilenameSuggestion object to <code>suggest</code> wins. In order to
-    // avoid confusion regarding which extension will win, users should not
-    // install extensions that may conflict. If the download is initiated by
+    // <code>FilenameSuggestion</code> object to <code>suggest</code> wins. In
+    // order to avoid confusion regarding which extension will win, users should
+    // not install extensions that may conflict. If the download is initiated by
     // $ref:download and the target filename is known before the MIME type and
     // tentative filename have been determined, use
-    // $ref:DownloadOptions.filename instead.
+    // <code>DownloadOptions.filename</code> instead.
     [maxListeners=1] static void onDeterminingFilename(
         DownloadItem downloadItem, SuggestFilenameCallback suggest);
   };