Extensions Docs Server: Doc conversion script

chrome/common/extensions/docs/server2/templates/articles/whats_new.html

Index: chrome/common/extensions/docs/server2/templates/articles/whats_new.html
diff --git a/chrome/common/extensions/docs/server2/templates/articles/whats_new.html b/chrome/common/extensions/docs/server2/templates/articles/whats_new.html
new file mode 100644
index 0000000000000000000000000000000000000000..b0b2cd4d86d62190a01fdff8dfe1ba108a8387bd
--- /dev/null
+++ b/chrome/common/extensions/docs/server2/templates/articles/whats_new.html
@@ -0,0 +1,596 @@
+<h1>What's New in Extensions?</h1>
+<!--  -->
+
+<p>
+This page lists the API and manifest changes
+made in recent releases.
+</p>
+
+<ul>
+  <li> <a href="#20">Google Chrome 20</a> </li>
+  <li> <a href="#19">Google Chrome 19</a> </li>
+  <li> <a href="#18">Google Chrome 18</a> </li>
+  <li> <a href="#17">Google Chrome 17</a> </li>
+  <li> <a href="#16">Google Chrome 16</a> </li>
+  <li> <a href="#15">Google Chrome 15</a> </li>
+  <li> <a href="#14">Google Chrome 14</a> </li>
+  <li> <a href="#13">Google Chrome 13</a> </li>
+  <li> <a href="#12">Google Chrome 12</a> </li>
+  <li> <a href="#11">Google Chrome 11</a> </li>
+  <li> <a href="#10">Google Chrome 10</a> </li>
+  <li> <a href="#9">Google Chrome 9</a> </li>
+  <li> <a href="#8">Google Chrome 8</a> </li>
+  <li> <a href="#7">Google Chrome 7</a> </li>
+  <li> <a href="#6">Google Chrome 6</a> </li>
+</ul>
+
+<p class="note">
+  <strong>New version of packaged apps:</strong><br>
+  There's a new version of
+  <a href="http://developer.chrome.com/trunk/apps/about_apps.html">packaged apps</a>
+  in the <a href="http://dev.chromium.org/getting-involved/dev-channel?">dev channel</a>.
+</p>
+
+<p>
+In addition to the changes listed below,
+check out the
+<a href="experimental.html">experimental APIs</a>.
+</p>
+
+<h2 id="20"> Google Chrome 20 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The
+      <a href="storage.html">storage API</a>
+      lets you store, retrieve, and
+      track changes to user data.</li>
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>Manifest version 1 was deprecated in Chrome 18
+      and will be phased out according to the
+      <a href="manifestVersion.html">Manifest version 1 support schedule</a>.</li>
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The <code>chrome.contextMenus</code>
+      <a href="contextMenus.html#method-create">create()</a> and
+      <a href="contextMenus.html#method-update">update()</a>
+      methods now have an <code>enabled</code> parameter.</li>
+    <li>The privacy API's <a href="privacy.html#property-services">services</a> object
+      now has a <code>spellingServiceEnabled</code> setting.</li>
+    <li>The <code>chrome.tabs</code>
+      <a href="tabs.html#method-executeScript">executeScript()</a> and
+      <a href="tabs.html#method-insertCSS">insertCSS()</a>
+      now accept a <code>runAt</code> parameter.</li>
+  </ul>
+
+<h4> Changes to existing APIs </h4>
+
+  <ul>
+    <li>The <code>sendRequest()</code> method
+      has been deprecated in favor of the
+      <code>sendMessage()</code> method for both the
+      <a href="extension.html#method-sendMessage">extension API</a> and
+      <a href="tabs.html#method-sendMessage">tabs API</a>.</li>
+    <li>The <a href="external_extensions.html">external_extensions.json file</a>
+      has been deprecated in favor of individual
+      <code>&lt;extension-id&gt;.json</code> files.</li>
+  </ul>
+
+<h2 id="19"> Google Chrome 19 </h2>
+
+<h4> New APIs </h4>
+   <ul>
+     <li>The <a href="browsingData.html">browsing data API</a>
+      lets you remove browsing data from a user's local profile.
+    <li>The <a href="topSites.html">top sites API</a>
+      gives you access to the top sites
+      that are displayed on the new tab page.
+   </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new <a href="manifest.html#intents">intents</a>
+      field specifies all intent handlers provided by the extension.
+  </ul>
+
+ <h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The window API's <a href="windows.html#type-windows.Window">Window</a>
+      object now has an <code>alwaysOnTop</code> property and
+       supports the "fullscreen" state.
+     <li>The <code>chrome.tabs</code>
+       <a href="tabs.html#method-query">query()</a> method
+       now has the <code>currentWindow</code> and
+      <code>lastFocusedWindow</code> parameters.
+     <li>The <a href="browserAction.html">browser action API</a>
+       has the following new getter functions:
+       <a href="browserAction.html#method-getTitle">getTitle</a>,
+       <a href="browserAction.html#method-getBadgeText">getBadgeText</a>,
+       <a href="browserAction.html#method-getBadgeBackgroundColor">getBadgeBackgr
+     oundColor</a>, and
+       <a href="browserAction.html#method-getPopup">getPopup</a>.
+    <li>The <a href="pageAction.html">page action API</a>
+      has the following new getter functions:
+       <a href="pageAction.html#method-getTitle">getTitle</a> and
+       <a href="pageAction.html#method-getPopup">getPopup</a>.
+   </ul>
+
+<h2 id="18"> Google Chrome 18 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The <a href="debugger.html">debugger API</a>
+      lets you use the Chrome Developer Tools
+      on one or more tabs remotely.
+    <li>The <a href="devtools.html">developer tools APIs</a>
+      provide support for extending Chrome Developer Tools.
+      The inspected window API lets you interact with the inspected window.
+      The network API lets you retrive information about network requests.
+      The panels API lets you add panels and sidebars.
+    <li>The <a href="input.ime.html">input method editor API</a>
+      lets you add custom input methods
+      such as complex language characters
+      directly to the system's input device.
+    <li>The <a href="pageCapture.html">page capture API</a>
+      lets you save a tab as MHTML.
+    <li> The <a href="privacy.html">privacy API</a>
+      lets you control usage of the features
+      in Chrome that can affect a user's privacy policy.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new
+      <a href="manifest.html#manifest_version">manifest version</a>
+      field specifies the version of the manifest that your package requires.
+      As of Chrome 18, you should use
+      <a href="manifestVersion.html">manifest version 2</a>.
+    <li>The new
+      <a href="contentSecurityPolicy.html">Content Security Policy (CSP)</a>
+      field is used to define an extension's policies
+      towards the types of content
+      that can be loaded and executed by the extension.
+    <li>Most background pages only include a list of script files.
+      For these background pages,
+      you can use the new
+      <a href="background_pages.html">background.scripts</a> property
+      and Chrome will generate a background page for you.
+    <li>The new
+      <a href="manifest.html#web_accessible_resources">web_accessible_resources</a>
+      field specifies the paths of packaged resources
+      that are expected to be usable in the context of a web page.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The <a href="windows.html#property-WINDOW_ID_CURRENT">windows API</a>
+    now has a <code>WINDOW_ID_CURRENT</code> property.
+    <li>The <code>chrome.tabs</code>
+    <a href="tabs.html#method-create">create()</a> and
+    <a href="tabs.html#method-update">update()</a> methods
+    now have an <code>openerTabId</code> parameter.
+  </ul>
+
+<h2 id="17"> Google Chrome 17 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The
+      <a href="webRequest.html">web request API</a>
+      lets you intercept, block, or
+      modify requests in-flight and
+      to observe and analyze traffic.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>Permissions can be
+      <a href="permissions.html">optional</a>
+      for the content setting API, the web navigation API, and
+      the new web request API.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The management API's
+    <a href="management.html#type-management.ExtensionInfo">ExtensionInfo</a> object
+    now has a <code>disabledReason</code> property.
+  </ul>
+
+<h4> Changes to existing APIs </h4>
+
+  <ul>
+    <li>The <a href="omnibox.html">omnibox API</a>
+    now works in
+    <a href="manifest.html#incognito">split incognito mode</a>.
+  </ul>
+
+<h2 id="16"> Google Chrome 16 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The
+      <a href="webNavigation.html">web navigation API</a>
+      lets extensions receive notifications about the status
+      of navigation requests.
+      You can use this API to track navigation events.
+    <li>The
+      <a href="permissions.html">optional permissions API</a>
+      lets you control when users are presented with permission requests.
+    <li>The
+      <a href="contentSettings.html">content settings API</a>
+      lets extensions customize Chrome’s behavior
+      on a per-site basis instead of globally.
+      You can use this API to control whether websites can use features
+      such as cookies, JavaScript, and plug-ins.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new
+      <a href="manifest.html#requirements">requirements</a> field
+      allows you to declare extension requirements up front.
+      For example, you can use this field
+      to specify that your app requires 3D graphics support
+      in order to use features such as CSS 3D Tranforms or WebGL.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The new
+    <a href="tabs.html#method-query">chrome.tabs.query()</a> method
+    gets all tabs that have the specified properties or
+    all tabs if no properties are specified.
+    <li>The new
+    <a href="tabs.html#method-reload">chrome.tabs.reload()</a> method
+    reloads a tab and includes the option
+    to preserve the local cache of the reloaded tab.
+    <li>The management API's
+    <a href="management.html#type-management.ExtensionInfo">ExtensionInfo</a> object
+    now has an <code>updateURL</code> property.
+    <li>You can now limit the supported locales for an
+    <a href="external_extensions.html">external extension</a>
+    by adding the <code>supported_locales</code> attribute
+    to the <code>external_extensions.json</code>.
+  </ul>
+
+<h4> Changes to existing APIs </h4>
+  <ul>
+    <li>The methods <code>getAllInWindow()</code> and
+    <code>getSelected()</code> have been deprecated.
+    To get details about all tabs in the specified window, use
+    <a href="tabs.html#method-query">chrome.tabs.query()</a>
+    with the argument <code>{'windowId': windowID}</code>.
+    To get the tab that is selected in the specified window, use
+    <code>chrome.tabs.query()</code>
+    with the argument <code>{'active': true}</code>.
+    <li>You are no longer required
+    to specify the <code>tabID</code> for the
+    <a href="tabs.html#method-update">chrome.tabs.update()</a> method.
+    When not provided,
+    the <code>tabID</code> defaults
+    to the selected tab of the current window.
+    <li>External extension files on Mac OS can now be owned by users
+    within a wheel group (or an admin group).
+    <li>The "experimental" permission is no longer required
+    for the
+    <a href="windows.html#type-windows.Window">window "panel"</a> type.
+    By default, the "panel" type creates a popup
+    unless the <code>--enable-panels</code> flag is set.
+  </ul>
+
+<h2 id="15"> Google Chrome 15 </h2>
+
+<h4> New APIs </h4>
+
+<ul>
+ <li>The <a href="webstore.html">webstore API</a>
+ lets you initiate app and extensions installations
+ <a href="http://code.google.com/chrome/webstore/docs/inline_installation.html">"inline"</a>
+ from your site.
+</ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new
+      <a href="manifest.html#offline_enabled">offline_enabled</a> field
+      lets you specify that your app works well even without an internet
+      connection.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>You can retrieve permission warnings using the new management API methods
+      <a href="management.html#method-getPermissionWarningsById">getPermissionWarningsById()</a>
+      and
+      <a href="management.html#method-getPermissionWarningsByManifest">getPermissionWarningsByManifest()</a>.
+    <li>The management API’s
+      <a href="management.html#type-management.ExtensionInfo">ExtensionInfo</a> object has
+      a new field, <code>offlineEnabled</code>.
+    <li>You can now <a href="i18n.html">internationalize</a> content script CSS
+      files by using <code>__MSG_messagename__</code> placeholders.
+  </ul>
+
+<h4> Changes to existing APIs </h4>
+  <ul>
+    <li>The callback for the <a href="tabs.html#method-update">tabs.update</a>
+      method is passed <code>null</code> instead of the tab details if the
+      extension does not have the "tabs" permission.
+  </ul>
+
+<h2 id="14"> Google Chrome 14 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The <a href="tts.html">tts API</a>
+      lets extensions generate speech from text.
+    <li>The <a href="ttsEngine.html">ttsEngine API</a>
+      lets extensions implement text-to-speech (TTS) engines.
+    <li>Extensions that are distributed through the Chrome Web Store
+      can now include Native Client modules.
+      No special manifest entry is necessary, as you can see from the
+      <a href="http://code.google.com/p/naclports/source/browse#svn%2Ftrunk%2Fsrc%2Fpackages%2Flibraries%2Fnethack-3.4.3">NetHack example</a>.
+      For more information, see the
+      <a href="http://blog.chromium.org/2011/08/native-client-brings-sandboxed-native.html">announcement</a> and the
+      <a href="http://code.google.com/chrome/nativeclient/">Native Client documentation</a>.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new
+      <a href="manifest.html#content_security_policy">content_security_policy</a> field
+      can help prevent
+      <a href="http://blog.chromium.org/2011/07/writing-extensions-more-securely.html">cross-site scripting vulnerabilities</a>
+      in your extension.
+    <li>The new <a href="manifest.html#nacl_modules">nacl_modules</a> field
+      lets you register Native Client modules
+      as content handlers for MIME types.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li><a href="contextMenus.html">Context menu</a> items
+      can now appear even in documents
+      that have file:// or chrome:// URLs.
+      Previously, they were restricted to documents with
+      http:// or https:// URLs.
+    <li>An optional <code>drawAttention</code> field in
+      <a href="windows.html#method-update">chrome.windows.update()</a>'s
+      <code>updateInfo</code> object lets you specify that the window
+      should entice the user to change focus to it.
+    <li>The new
+      <a href="bookmarks.html#method-getSubTree">bookmarks.getSubTree()</a>
+      function lets you retrieve just part of the Bookmarks hierarchy.
+  </ul>
+
+<h4> Changes to existing APIs </h4>
+  <ul>
+    <li>The "tabs" permission is no longer required for
+      <a href="tabs.html#method-remove">tabs.remove</a> and
+      <a href="tabs.html#event-onRemoved">tabs.onRemoved</a>.
+  </ul>
+
+<h2 id="13"> Google Chrome 13 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The <a href="proxy.html">proxy API</a>
+      lets extensions manage Chrome's proxy settings.
+    <li>The
+      <a href="types.html#type-types.ChromeSetting">chrome.types.ChromeSetting</a> prototype
+      provides an interface to browser settings;
+      it's used by the proxy API.
+    <li> <em>Chrome OS only:</em>
+      The <a href="fileBrowserHandler.html">fileBrowserHandler API</a>
+      lets you extend the Chrome OS file browser.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>A new <code>exclude_matches</code> item
+      in the "content_scripts" field
+      lets you target your content script more precisely.
+      For details, see
+      <a href="content_scripts.html#match-patterns-globs">Match patterns and globs</a>.
+    <li>New "clipboardRead" and "clipboardWrite"
+      <a href="manifest.html#permissions">permissions</a>
+      specify capabilities for <code>document.execCommand()</code>.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>Content scripts can now make
+      <a href="xhr.html">cross-origin XMLHttpRequests</a>
+      to the same sites that their parent extension can,
+      eliminating the need to relay these requests
+      through a background page.
+    <li>You can now use <code>@run-at</code>
+      in an imported Greasemonkey script
+      to control when the script is injected.
+      It works the same way as
+      <a href="content_scripts.html#run_at"><code>run_at</code></a>
+      in content scripts.
+  </ul>
+
+<h2 id="12"> Google Chrome 12 </h2>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>Two new <code>chrome.extension</code>
+      methods&mdash;<a href="extension.html#method-isAllowedFileSchemeAccess">isAllowedFileSchemeAccess()</a> and
+      <a href="extension.html#method-isAllowedIncognitoAccess">isAllowedIncognitoAccess()</a>&mdash;let you
+      determine whether your extension has increased access,
+      which the user specifies using the extensions management page
+      (<b>chrome://extensions</b>).
+    <li>The <a href="windows.html#method-create">chrome.windows.create()</a>
+      method can now take a <code>focused</code> value.
+      Previously, all new windows had the keyboard focus;
+      now you can create windows without interrupting the user's typing.
+    <li>If the manifest specifies "experimental" permission,
+      your extension can specify "panel" as the value of
+      the <code>type</code> field in
+      the <a href="windows.html#method-create">chrome.windows.create()</a>
+      method
+      or the <a href="windows.html#type-windows.Window">Window</a> type.
+    <li>The <a href="cookies.html#event-onChanged">onChanged</a>
+      event of <code>chrome.cookies</code>
+      now has a <code>cause</code> parameter.
+    <li>The <code>chrome.contextMenus</code>
+      <a href="contextMenus.html#method-create">create()</a> and
+      <a href="contextMenus.html#method-update">update()</a>
+      methods now let you specify a context value of "frame".
+  </ul>
+
+<h2 id="11"> Google Chrome 11 </h2>
+
+<h4> Changes to existing APIs </h4>
+  <ul>
+    <li>For security reasons, you can no longer call
+      <a href="tabs.html#method-captureVisibleTab">chrome.tab.captureVisibleTab()</a>
+      on just any tab.
+      Instead, you now must have
+      <a href="manifest.html#permissions">host permission</a>
+      for the URL displayed by that tab.
+      To get the previous behavior,
+      specify <code>&lt;all_urls></code> for the host permission.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The management API's
+      <a href="management.html#type-management.ExtensionInfo">ExtensionInfo</a> object
+      now has a <code>homepageUrl</code> property.
+    <li>The management API now lets you get the icons of
+      disabled apps and extensions.
+      Also, you can now modify the regular icon's URL
+      to get its disabled equivalent.
+      See <a href="management.html#type-management.IconInfo">IconInfo</a> for details.
+    <li>The cookies API
+      <a href="cookies.html#method-set">set()</a>
+      and <a href="cookies.html#method-remove">remove()</a> methods
+      can now take callbacks.
+  </ul>
+
+<h2 id="10"> Google Chrome 10 </h2>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The new <a href="manifest.html#bg">background</a> permission
+      extends the life of Chrome,
+      allowing your extension or app
+      to run even when Chrome has no windows open.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The <a href="windows.html#method-create">chrome.windows.create()</a>
+      method now has a <code>tabId</code> field.
+      You can use it to move a tab or panel into a new window.
+      <p class="note">
+      <b>Note:</b>
+      This change was incorrectly attributed to Chrome 9
+      in previous release notes.
+  </ul>
+
+<h2 id="9"> Google Chrome 9 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The <a href="omnibox.html">omnibox API</a> allows you to
+      register a keyword with Chrome's address bar.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The <a href="manifest.html#homepage_url">homepage_url</a> field
+      lets you specify the extension or app's homepage.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The <a href="tabs.html#type-tabs.Tab">Tab</a> object
+      now has a <code>pinned</code> property
+      that's reflected in various <code>chrome.tabs</code> methods.
+      For example,
+      you can <a href="tabs.html#method-create">create</a>
+      a pinned tab.
+    <li>The <a href="windows.html#method-create">chrome.windows.create()</a>
+      method can now take a list of URLs,
+      letting you create multiple tabs in the new window.
+    <li>The new
+      <a href="management.html#method-get">chrome.management.get()</a> method
+      lets you get information about the specified extension or app.
+  </ul>
+
+
+<h2 id="8"> Google Chrome 8 </h2>
+
+<p>
+We took a break for Chrome 8.
+No API or manifest changes worth noting.
+</p>
+
+
+<h2 id="7"> Google Chrome 7 </h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>All users can now install
+      <a href="http://code.google.com/chrome/apps/index.html">apps</a>;
+      packaged apps can use extension APIs.
+    <li>The <a href="management.html">management API</a>
+      lets you work with installed apps and extensions.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>Introduced <a href="manifest.html#incognito">split incognito</a>
+      mode as the default for installable web apps
+      (also available to extensions).
+    <li>The <a href="tabs.html">tabs API</a>
+      <code>create()</code> and <code>update()</code> methods
+      no longer require the "tabs" permission, removing one common cause of
+      <a href="permission_warnings.html">scary dialogs</a>.
+  </ul>
+
+
+<h2 id="6">Google Chrome 6</h2>
+
+<h4> New APIs </h4>
+  <ul>
+    <li>The <a href="contextMenus.html">context menus API</a> allows you to
+      add context menus to pages or specific objects on a page.
+    <li>The <a href="cookies.html">cookies API</a> allows you to manage the
+      browser's cookie system.
+    <li>The <a href="idle.html">idle API</a> allows you to detect when the
+      machine's idle state changes.
+  </ul>
+
+<h4> Additions to existing APIs </h4>
+  <ul>
+    <li>The <a
+      href="extension.html#method-getViews">chrome.extension.getViews()</a>
+      method can now return popup views.
+    <li>A new <a
+      href="windows.html#property-WINDOW_ID_NONE">WINDOW_ID_NONE</a> constant
+      identifies when focus shifts away from the browser.
+    <li>The new <a
+      href="tabs.html#method-getCurrent">chrome.tabs.getCurrent()</a> method
+      returns the tab associated with the currently executing script.
+  </ul>
+
+<h4> Manifest changes </h4>
+  <ul>
+    <li>The <a href="manifest.html#geolocation">geolocation</a> permission
+      gives an extension access to the user's physical location.
+    <li><a href="match_patterns.html">Match patterns</a> can now select all
+      schemes or all URLs.
+    <li>Access to file:/// URLs no longer triggers the "access to your machine"
+      security warning, but now requires user opt-in from the extensions
+      management page.
+  </ul>