Bug 295902 - Document tab drag-and-droppability. r=steffen, a=asa

git-svn-id: svn://10.0.0.236/trunk@174603 18797224-902f-48f8-a5cc-f745e15eee43

mozilla/browser/locales/en-US/chrome/help/shortcuts.xhtml

@@ -293,6 +293,36 @@ Contributors:
       <td>&accelKey;+<kbd>W</kbd><br/>
         &altKey;+<kbd>F4</kbd></td>
     </tr>
+    <!-- LOCALIZATION NOTE:
+         "Left"/"Up" and "Right"/"Down" might need special treatment
+         for bidi locales, as used in the following two entries.
+    -->
+    <tr>
+      <td>Move Tab Left (when tab is focused)</td>
+      <td>&accelKey;+<kbd>Left Arrow</kbd><br/>
+          &accelKey;+<kbd>Up Arrow</kbd></td>
+      <td>&nbsp;</td>
+      <td>&nbsp;</td>
+    </tr>
+    <tr>
+      <td>Move Tab Right (when tab is focused)</td>
+      <td>&accelKey;+<kbd>Right Arrow</kbd><br/>
+          &accelKey;+<kbd>Down Arrow</kbd></td>
+      <td>&nbsp;</td>
+      <td>&nbsp;</td>
+    </tr>
+    <tr>
+      <td>Move Tab to Beginning (when tab is focused)</td>
+      <td>&accelKey;+<kbd>Home</kbd></td>
+      <td>&nbsp;</td>
+      <td>&nbsp;</td>
+    </tr>
+    <tr>
+      <td>Move Tab to End (when tab is focused)</td>
+      <td>&accelKey;+<kbd>End</kbd></td>
+      <td>&nbsp;</td>
+      <td>&nbsp;</td>
+    </tr>
     <tr>
       <td>New Tab</td>
       <td>&accelKey;+<kbd>T</kbd></td>

mozilla/browser/locales/en-US/chrome/help/tabbed_browsing.xhtml

@@ -64,6 +64,16 @@ Contributors:
   <p>To open a URL in the Location Bar in a new tab, enter the URL and press
     &altKey;+&enterKey;.</p>
 
+  <h3 id="moving_tabs">Moving Tabs Within a Window</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 a small indicator to show
+    where the tab will be moved.  Alternately, you can use
+    <a href="#keyboard_shortcuts">keyboard shortcuts</a> to move tabs within a
+    window if desired.</p>
+
   <h3 id="closing_tabs">Closing Tabs</h3>
 
   <p>To close the current tab, press &accelKey;+<kbd>W</kbd>, click the Close
@@ -84,7 +94,11 @@ Contributors:
     pressing <span class="noUnix">&accelKey;</span><span
     class="unix">&altKey;</span>+<kbd>1</kbd>, and so on up to the 9th tab with
     <span class="noUnix">&accelKey;</span><span
-    class="unix">&altKey;</span>+<kbd>9</kbd>.</p>
+    class="unix">&altKey;</span>+<kbd>9</kbd>.  To move a tab within a window,
+    press &accelKey; with the appropriate key from <kbd>Left Arrow</kbd>,
+    <kbd>Right Arrow</kbd>, <kbd>Up Arrow</kbd>, or <kbd>Down Arrow</kbd>.  To
+    move a tab to the beginning or end of the tabs in the window, use
+    &accelKey; with either <kbd>Home</kbd> or <kbd>End</kbd>, respectively.</p>
 
   <h3 id="bookmarking_tabbed_browsing">Bookmarks and Tabbed Browsing</h3>
 
@@ -113,7 +127,7 @@ Contributors:
 <h2 id="customizing">Customizing Tabbed Browsing</h2>
 
 <p>To customize tabbed browsing, select &pref.menuPath; and open the
-  <em>Tabs</em> panel. &pref.pluralCaps; for tabbed browsing can be found
+  <em>Tabs</em> panel. Descriptions of the &pref.plural; there can be found
   under <a href="prefs.xhtml#tabs_options">Tabbed Browsing</a>.</p>
 
   <h3 id="tips">Helpful Tips</h3>