Bug 316258 Document new tab feature (Reorder / Rearrange / Move browser tabs). Patch by Giacomo Magnini <giacomo.magnini@portalis.it>. r=iann_bugzilla

suite/locales/en-US/chrome/common/help/customize_help.xhtml

@@ -233,6 +233,7 @@
     <li><a href="#what_is_tabbed_browsing">What is Tabbed Browsing?</a></li>
     <li><a href="#setting_up_tabbed_browsing">Setting up Tabbed Browsing</a></li>
     <li><a href="#opening_tabs">Opening Tabs</a></li>
+    <li><a href="#moving_tabs">Moving Tabs</a></li>
     <li><a href="#bookmarking_tabs">Bookmarking Tabs</a></li>
     <li><a href="#closing_tabs">Closing Tabs</a></li>
   </ul>
@@ -332,6 +333,21 @@
 
 <p>[<a href="#tabbed_browsing">Return to beginning of section</a>]</p>
 
+<h3 id="moving_tabs">Moving Tabs</h3>
+
+<p>Tabs are displayed in the order you open them, which may not always be what
+  you want. To move a tab to a different location within a &brandShortName;
+  window, simply drag it there using your mouse. While you are dragging the
+  tab, &brandShortName; displays an indicator to show where the tab will be
+  moved. Alternately, you can use
+  <a href="shortcuts-navigator.xhtml#tabbed_browsing_shortcuts">keyboard
+  shortcuts</a> to move tabs within a window if desired.</p>
+
+<p><strong>Note:</strong> The keyboard shortcuts don't work when a text box has
+  focus.</p>
+
+<p>[<a href="#tabbed_browsing">Return to beginning of section</a>]</p>
+
 <h3 id="bookmarking_tabs">Bookmarking Tabs</h3>
 
 <p>A bookmarked group of tabs is called a Groupmark. To bookmark the group of

suite/locales/en-US/chrome/common/help/help-index1.rdf

@@ -192,7 +192,8 @@
        <rdf:Description ID="Composer"
          nc:name="Composer"
          nc:link="composer_help.xhtml"/>
-     </rdf:li><rdf:li>
+     </rdf:li>
+     <rdf:li>
        <rdf:Description ID="Cookie_Manager"
          nc:name="Cookie Manager"
          nc:link="using_priv_help.xhtml#using_the_cookie_manager"/>
@@ -2135,6 +2136,11 @@
          nc:name="using tabbed browsing"
          nc:link="nav_help.xhtml#using_tabbed_browsing"/>
      </rdf:li>
+     <rdf:li>
+       <rdf:Description ID="Tabbed_Browsing:moving_tabs"
+         nc:name="moving tabs"
+         nc:link="customize_help.xhtml#moving_tabs"/>
+     </rdf:li>
      <rdf:li>
        <rdf:Description ID="Tabbed_Browsing:opening_tabs"
          nc:name="opening tabs"

suite/locales/en-US/chrome/common/help/shortcuts-navigator.xhtml

@@ -383,13 +383,37 @@
     <td>Cmd+W</td>
     <td>Ctrl+W</td>
   </tr>
-  <tr>
+  <tr>
+    <td>Move Tab Left (when tab is focused)</td>
+    <td>Ctrl+Left Arrow or Ctrl+Up Arrow</td>
+    <td>Cmd+Left Arrow or Cmd+Up Arrow</td>
+    <td>Ctrl+Left Arrow or Ctrl+Up Arrow</td>
+  </tr>
+  <tr class="even">
+    <td>Move Tab Right (when tab is focused)</td>
+    <td>Ctrl+Right Arrow or Ctrl+Down Arrow</td>
+    <td>Cmd+Right Arrow or Cmd+Down Arrow</td>
+    <td>Ctrl+Right Arrow or Ctrl+Down Arrow</td>
+  </tr>
+  <tr>
+    <td>Move Tab to Beginning (when tab is focused)</td>
+    <td>Ctrl+Home</td>
+    <td>Cmd+Home</td>
+    <td>Ctrl+Home</td>
+  </tr>
+  <tr class="even">
+    <td>Move Tab to End (when tab is focused)</td>
+    <td>Ctrl+End</td>
+    <td>Cmd+End</td>
+    <td>Ctrl+End</td>
+  </tr>
+  <tr class="even">
     <td>Open link in new foreground tab</td>
     <td>Insert</td>
     <td></td>
     <td>Insert</td>
   </tr>
-  <tr class="even">
+  <tr>
     <td>Open link in new background tab</td>
     <td>Shift+Insert</td>
     <td></td>

suite/locales/en-US/chrome/common/help/suite-toc.rdf

@@ -695,6 +695,7 @@ nc:link="chrome://help/locale/nav_help.xhtml#plugins_and_downloads"/> </rdf:li>
         <rdf:li> <rdf:Description ID="cust-tabbed-whatis" nc:name="What is Tabbed Browsing?"  nc:link="customize_help.xhtml#what_is_tabbed_browsing"/> </rdf:li>
         <rdf:li> <rdf:Description ID="cust-tabbed-tabbedsetting" nc:name="Setting up Tabbed Browsing"  nc:link="customize_help.xhtml#setting_up_tabbed_browsing"/> </rdf:li>
         <rdf:li> <rdf:Description ID="cust-tabbed-tabbedopening" nc:name="Opening Tabs"  nc:link="customize_help.xhtml#opening_tabs"/> </rdf:li>
+        <rdf:li> <rdf:Description ID="cust-tabbed-tabbedmoving" nc:name="Moving Tabs"  nc:link="customize_help.xhtml#moving_tabs"/> </rdf:li>
         <rdf:li> <rdf:Description ID="cust-tabbed-tabbedbookmarking" nc:name="Bookmarking Tabs"  nc:link="customize_help.xhtml#bookmarking_tabs"/> </rdf:li>
         <rdf:li> <rdf:Description ID="cust-tabbed-tabbedclosing" nc:name="Closing Tabs"  nc:link="customize_help.xhtml#closing_tabs"/> </rdf:li>
       </rdf:Seq>