Extension docs: Make comments in IDL files generate paragraphs rather than

chrome/common/extensions/api/app_window.idl

 // 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.
 
 // Use the <code>chrome.app.window</code> API to create windows. Windows
 // have an optional frame with title bar and size controls. They are not
 // associated with any Chrome browser windows. See the <a
 // href="https://github.com/GoogleChrome/chrome-app-samples/tree/master/window-state">
 // Window State Sample</a> for a demonstration of these options.
 namespace app.window {
@@ skipping 81 matching lines @@
     static void setMinimumSize(long minWidth, long minHeight);
 
     // Set the maximum size constraints of the content or window. The maximum
     // width or height can be set to <code>null</code> to remove the constraint.
     // A value of <code>undefined</code> will leave a constraint unchanged.
     static void setMaximumSize(long maxWidth, long maxHeight);
   };
 
   dictionary FrameOptions {
     // Frame type: <code>none</code> or <code>chrome</code> (defaults to
-    // <code>chrome</code>).<br>
+    // <code>chrome</code>).
+    //
     // For <code>none</code>, the <code>-webkit-app-region</code> CSS property
     // can be used to apply draggability to the app's window.
+    //
     // <code>-webkit-app-region: drag</code> can be used to mark regions
     // draggable. <code>no-drag</code> can be used to disable this style on
-    // nested elements.<br>
+    // nested elements.
     DOMString? type;
     // Allows the frame color to be set. Frame coloring is only available if the
-    // frame type is <code>chrome</code>.<br>
+    // frame type is <code>chrome</code>.
+    //
     // Frame coloring is new in Chrome 36.
     DOMString? color;
     // Allows the frame color of the window when active to be set. Frame
-    // coloring is only available if the frame type is <code>chrome</code>.<br>
+    // coloring is only available if the frame type is <code>chrome</code>.
+    //
     // Frame coloring is only available if the frame type is
-    // <code>chrome</code>.<br>
+    // <code>chrome</code>.
+    //
     // Frame coloring is new in Chrome 36.
     DOMString? activeColor;
     // Allows the frame color of the window when inactive to be set differently
     // to the active color. Frame
-    // coloring is only available if the frame type is <code>chrome</code>.<br>
+    // coloring is only available if the frame type is <code>chrome</code>.
+    //
     // <code>inactiveColor</code> must be used in conjunction with <code>
-    // color</code>.<br>
+    // color</code>.
+    //
     // Frame coloring is new in Chrome 36.
     DOMString? inactiveColor;
   };
 
   // State of a window: normal, fullscreen, maximized, minimized.
   enum State { normal, fullscreen, maximized, minimized };
 
   // 'shell' is the default window type. 'panel' is managed by the OS
   // (Currently experimental, Ash only).
   [nodoc] enum WindowType { shell, panel };
@@ skipping 72 matching lines @@
     [deprecated="Use innerBounds or outerBounds."] long? maxHeight;
 
     // Type of window to create.
     [nodoc] WindowType? type;
 
     // Frame type: <code>none</code> or <code>chrome</code> (defaults to
     // <code>chrome</code>). For <code>none</code>, the
     // <code>-webkit-app-region</code> CSS property can be used to apply
     // draggability to the app's window. <code>-webkit-app-region: drag</code>
     // can be used to mark regions draggable. <code>no-drag</code> can be used
-    // to disable this style on nested elements.<br>
+    // to disable this style on nested elements.
+    //
     // Use of <code>FrameOptions</code> is new in M36.
     (DOMString or FrameOptions)? frame;
 
     // Size and position of the content in the window (excluding the titlebar).
     // If an id is also specified and a window with a matching id has been shown
     // before, the remembered bounds of the window will be used instead.
     [deprecated="Use innerBounds or outerBounds."] ContentBounds? bounds;
 
     // Enable window background transparency.
     // Only supported in ash. Requires experimental API permission.
@@ skipping 13 matching lines @@
     // By default if you specify an id for the window, the window will only be
     // created if another window with the same id doesn't already exist. If a
     // window with the same id already exists that window is activated instead.
     // If you do want to create multiple windows with the same id, you can
     // set this property to false.
     [deprecated="Multiple windows with the same id is no longer supported."] boolean? singleton;
 
     // If true, the window will stay above most other windows. If there are
     // multiple windows of this kind, the currently focused window will be in
     // the foreground. Requires the <code>"alwaysOnTopWindows"</code>
-    // permission. Defaults to false.<br>
+    // permission. Defaults to false.
+    //
     // Call <code>setAlwaysOnTop()</code> on the window to change this property
-    // after creation.<br>
+    // after creation.
     boolean? alwaysOnTop;
 
     // If true, the window will be focused when created. Defaults to true.
     boolean? focused;
   };
 
   // Called in the creating window (parent) before the load event is called in
   // the created window (child). The parent can set fields or functions on the
-  // child usable from onload. E.g. background.js:<br>
+  // child usable from onload. E.g. background.js:
+  //
   // <code>function(createdWindow) { createdWindow.contentWindow.foo =
   // function () { }; };</code>
-  // <br>window.js:<br>
+  //
+  // window.js:
+  //
   // <code>window.onload = function () { foo(); }</code>
   callback CreateWindowCallback =
       void ([instanceOf=AppWindow] object createdWindow);
 
   [noinline_doc] dictionary AppWindow {
     // Focus the window.
     static void focus();
 
-    // Fullscreens the window.<br>
+    // Fullscreens the window.
+    //
     // The user will be able to restore the window by pressing ESC. An
     // application can prevent the fullscreen state to be left when ESC is
     // pressed by requesting the <b>overrideEscFullscreen</b> permission and
-    // canceling the event by calling .preventDefault(), like this:<br>
+    // canceling the event by calling .preventDefault(), like this:
+    //
     // <code>window.onKeyDown = function(e) { if (e.keyCode == 27 /* ESC */) {
     // e.preventDefault(); } };</code>
     static void fullscreen();
 
     // Is the window fullscreen?
     static boolean isFullscreen();
 
     // Minimize the window.
     static void minimize();
 
@@ skipping 149 matching lines @@
     // Fired when the window is restored from being minimized or maximized.
     [nocompile] static void onRestored();
 
     // Fired when the window's ability to use alpha transparency changes.
     [nocompile, nodoc] static void onAlphaEnabledChanged();
 
     // Event for testing. Lets tests wait until a window has been shown.
     [nocompile, nodoc] static void onWindowFirstShown();
   };
 };