Bug 232063 - Shortcuts for Text Viewing, Navigation, and Selection. r=stefanh.
authorRicardo Palomares <rpmdisguise-otros@yahoo.es>
Sun, 21 Nov 2010 20:28:28 +0100
changeset 6730 46dd15659816143494ee3c3e669ebea75916a601
parent 6729 2ceaa8229eb1aca1e56b8a91be232ca4f7ee00cd
child 6731 09778c4043bc4e72c6d85e593a67f8a89a63fbca
push idunknown
push userunknown
push dateunknown
reviewersstefanh
bugs232063
Bug 232063 - Shortcuts for Text Viewing, Navigation, and Selection. r=stefanh.
suite/locales/en-US/chrome/common/help/glossary.xhtml
suite/locales/en-US/chrome/common/help/help-glossary.rdf
suite/locales/en-US/chrome/common/help/shortcuts.xhtml
suite/locales/en-US/chrome/common/help/shortcuts_navigator.xhtml
suite/locales/en-US/chrome/common/help/suite-toc.rdf
--- a/suite/locales/en-US/chrome/common/help/glossary.xhtml
+++ b/suite/locales/en-US/chrome/common/help/glossary.xhtml
@@ -56,16 +56,22 @@
   on your computer&apos;s hard disk or in its random-access memory (RAM). The
   browser accumulates these copies as you browse the Web. When you click a link
   or type a <a href="#url">URL</a> to fetch a particular web page for which the
   cache already contains a copy, the browser compares the cached copy to the
   original. If there have been no changes, the browser uses the cached copy
   rather than refetching the original, saving processing and download
   time.</dd>
 
+<dt id="caret_browsing">caret browsing</dt><dd>A &brandShortName; feature that
+  allows you to navigate through text in Web pages and e-mail messages (or this
+  Help window) with a caret. Using your keyboard, you can navigate and select
+  text like you do in a text editor. You turn caret browsing mode on and off by
+  pressing the <kbd>F7</kbd> key.</dd>
+
 <dt id="certificate">certificate</dt><dd>The digital equivalent of an ID card.
   A certificate specifies the name of an individual, company, or other entity
   and certifies that a public key, which is included in the certificate,
   belongs to that entity. When you digitally sign a message or other data, the
   digital signature for that message is created with the aid of the private key
   that corresponds to the public key in your certificate. A certificate is
   issued and digitally signed by a <a href="#certificate_authority">certificate
   authority (CA)</a>. A certificate&apos;s validity can be verified by checking
--- a/suite/locales/en-US/chrome/common/help/help-glossary.rdf
+++ b/suite/locales/en-US/chrome/common/help/help-glossary.rdf
@@ -8,16 +8,17 @@
     <nc:subheadings>
       <rdf:Seq>
         <rdf:li> <rdf:Description nc:name="add-on" nc:link="glossary.xhtml#add-on"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="authentication" nc:link="glossary.xhtml#authentication"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="bookmark" nc:link="glossary.xhtml#bookmark"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="CA" nc:link="glossary.xhtml#ca"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="CA certificate" nc:link="glossary.xhtml#ca_certificate"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="cache" nc:link="glossary.xhtml#cache"/> </rdf:li>
+        <rdf:li> <rdf:Description nc:name="caret browsing" nc:link="glossary.xhtml#caret_browsing"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate" nc:link="glossary.xhtml#certificate"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate authority (CA)" nc:link="glossary.xhtml#certificate_authority"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate backup password" nc:link="glossary.xhtml#certificate_backup_password"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate-based authentication" nc:link="glossary.xhtml#certificate-based_authentication"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate chain" nc:link="glossary.xhtml#certificate_chain"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate fingerprint" nc:link="glossary.xhtml#certificate_fingerprint"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="Certificate Manager" nc:link="glossary.xhtml#certificate_manager"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="certificate renewal" nc:link="glossary.xhtml#certificate_renewal"/> </rdf:li>
--- a/suite/locales/en-US/chrome/common/help/shortcuts.xhtml
+++ b/suite/locales/en-US/chrome/common/help/shortcuts.xhtml
@@ -16,16 +16,17 @@
 
 <h1>&brandShortName; Keyboard Shortcuts</h1>
 
 <div class="contentsBox">In this section:
   <ul>
     <li><a href="#using_shortcuts">Using Shortcuts</a></li>
     <li><a href="#general_mozilla_shortcuts">General &brandShortName;
     Shortcuts</a></li>
+    <li><a href="#text_field_shortcuts">Text Field Shortcuts</a></li>
     <li><a href="#help_window_shortcuts">Help Window Shortcuts</a></li>
     <li><a href="shortcuts_navigator.xhtml">Browser Shortcuts</a></li>
     <li><a href="shortcuts_mailnews.xhtml">Mail &amp; Newsgroups
     Shortcuts</a></li>
     <li><a href="shortcuts_composer.xhtml">Composer Shortcuts</a></li>
   </ul>
 </div>
 
@@ -66,17 +67,17 @@
 <p><strong>Tip</strong>: The plus sign (+) means that you must press two keys
   surrounding the plus sign at the same time. If there is more than one plus
   sign (such as Ctrl+Shift+C), it means that all three buttons surrounding the
   plus sign must be pressed at the same time.</p>
 
 <p><strong>Abbreviations:</strong></p>
 
 <ul>
-  <li>Ctrl = Control Key</li>
+  <li>Ctrl = Control key</li>
   <li>Cmd = Command key on the Mac OS Keyboard</li>
 </ul>
 
 <p><strong>Note</strong>: Some keyboard shortcuts perform different functions
   based on cursor location (focus). For example, if you press Home on Windows
   while viewing a web page, &brandShortName; will move to the top of the web
   page. However, if you press Home on Windows while the cursor is in a text
   field, the cursor will go to the beginning of the text field.</p>
@@ -212,28 +213,16 @@
       Open Main Menu <span class="noMac">(switches to the first drop-down menu
       at the top of the window)</span>
     </td>
     <td>Alt or F10</td>
     <td>(Mac OS X: Controlled through keyboard preference in Control Panel)</td>
     <td>F10</td>
   </tr>
   <tr>
-    <td>Move to beginning of line (in a text editing field)</td>
-    <td>Home</td>
-    <td>Cmd+Left Arrow</td>
-    <td>Home</td>
-  </tr>
-  <tr>
-    <td>Move to end of line (in a text editing field)</td>
-    <td>End</td>
-    <td>Cmd+Right Arrow</td>
-    <td>End</td>
-  </tr>
-  <tr>
     <td>Exit &brandShortName;</td>
     <td>Ctrl+Q</td>
     <td>Cmd+Q</td>
     <td>Ctrl+Q</td>
   </tr>
   <tr>
     <td>Start Browser</td>
     <td>Ctrl+1</td>
@@ -283,19 +272,183 @@
     <td>Ctrl+Shift+J</td>
   </tr>
   <tr>
     <td>Open Help Window</td>
     <td>F1</td>
     <td>Cmd+?</td>
     <td>F1</td>
   </tr>
+  <tr>
+    <td>Turn on/off <a href="glossary.xhtml#caret_browsing">caret browsing</a></td>
+    <td>F7</td>
+    <td>F7 (if F7 is not programmed for another command)</td>
+    <td>F7</td>
+  </tr>
 </tbody>
 </table>
 
+<h2 id="text_field_shortcuts">Text Field Shortcuts</h2>
+
+<p>The following are keyboard commands for navigating and modifying text in a
+  text input field (e.g. the Location Bar). Except where indicated, these
+  commands also apply to Web pages and e-mail messages in caret browsing
+  mode.</p>
+
+<table class="defaultTable">
+<colgroup>
+  <col class="commandColumn"></col>
+  <col class="osFirstColumn"></col>
+  <col class="osSecondColumn"></col>
+  <col class="osThirdColumn"></col>
+</colgroup>
+<thead>
+  <tr>
+    <th>Command</th>
+    <th>Windows</th>
+    <th>Mac OS</th>
+    <th>Linux or Unix</th>
+  </tr>
+</thead>
+<tbody class="tbody-default">
+  <tr>
+    <td>Move one line up</td>
+    <td>Up Arrow</td>
+    <td>Up Arrow</td>
+    <td>Up Arrow</td>
+  </tr>
+  <tr>
+    <td>Move one line down</td>
+    <td>Down Arrow</td>
+    <td>Down Arrow</td>
+    <td>Down Arrow</td>
+  </tr>
+  <tr>
+    <td>Move one character left</td>
+    <td>Left Arrow</td>
+    <td>Left Arrow</td>
+    <td>Left Arrow</td>
+  </tr>
+  <tr>
+    <td>Move one character right</td>
+    <td>Right Arrow</td>
+    <td>Right Arrow</td>
+    <td>Right Arrow</td>
+  </tr>
+  <tr>
+    <td>Move to next word</td>
+    <td>Ctrl+Right Arrow</td>
+    <td>Opt+Right Arrow</td>
+    <td>Ctrl+Right Arrow</td>
+  </tr>
+  <tr>
+    <td>Move to previous word</td>
+    <td>Ctrl+Left Arrow</td>
+    <td>Opt+Left Arrow</td>
+    <td>Ctrl+Left Arrow</td>
+  </tr>
+  <tr>
+    <td>Move to beginning of line</td>
+    <td>Home</td>
+    <td>Cmd+Left Arrow<span class="mac"> (in text fields only)</span></td>
+    <td>Home</td>
+  </tr>
+  <tr>
+    <td>Move to end of line</td>
+    <td>End</td>
+    <td>Cmd+Right Arrow<span class="mac"> (in text fields only)</span></td>
+    <td>End</td>
+  </tr>
+  <tr>
+    <td>Move to beginning of text</td>
+    <td>Ctrl+Home</td>
+    <td>Cmd+Up Arrow</td>
+    <td>Ctrl+Home</td>
+  </tr>
+  <tr>
+    <td>Move to end of text</td>
+    <td>Ctrl+End</td>
+    <td>Cmd+Down Arrow</td>
+    <td>Ctrl+End</td>
+  </tr>
+  <tr>
+    <td>Select next character</td>
+    <td>Shift+Right Arrow</td>
+    <td>Shift+Right Arrow</td>
+    <td>Shift+Right Arrow</td>
+  </tr>
+  <tr>
+    <td>Select previous character</td>
+    <td>Shift+Left Arrow</td>
+    <td>Shift+Left Arrow</td>
+    <td>Shift+Left Arrow</td>
+  </tr>
+  <tr>
+    <td>Select next word</td>
+    <td>Ctrl+Shift+Right Arrow</td>
+    <td>Opt+Shift+Right Arrow</td>
+    <td>Ctrl+Shift+Right Arrow</td>
+  </tr>
+  <tr>
+    <td>Select previous word</td>
+    <td>Ctrl+Shift+Left Arrow</td>
+    <td>Opt+Shift+Left Arrow</td>
+    <td>Ctrl+Shift+Left Arrow</td>
+  </tr>
+  <tr>
+    <td>Select all text</td>
+    <td>Ctrl+A</td>
+    <td>Cmd+A</td>
+    <td>Ctrl+A</td>
+  </tr>
+  <tr>
+    <td>Copy</td>
+    <td>Ctrl+C</td>
+    <td>Cmd+C</td>
+    <td>Ctrl+C</td>
+  </tr>
+  <tr>
+    <td>Paste (in text fields only)</td>
+    <td>Ctrl+V</td>
+    <td>Cmd+V</td>
+    <td>Ctrl+V</td>
+  </tr>
+  <tr>
+    <td>Cut (in text fields only)</td>
+    <td>Ctrl+X</td>
+    <td>Cmd+X</td>
+    <td>Ctrl+X</td>
+  </tr>
+  <tr>
+    <td>Delete next character (in text fields only)</td>
+    <td>Del</td>
+    <td>Del</td>
+    <td>Del</td>
+  </tr>
+  <tr>
+    <td>Delete previous character (in text fields only)</td>
+    <td>Backspace</td>
+    <td>Backspace</td>
+    <td>Backspace</td>
+  </tr>
+  <tr>
+    <td>Delete next word (in text fields only)</td>
+    <td>Ctrl+Del</td>
+    <td>Opt+Del</td>
+    <td>Ctrl+Del</td>
+  </tr>
+  <tr>
+    <td>Delete previous word (in text fields only)</td>
+    <td>Ctrl+Backspace</td>
+    <td>Opt+Backspace</td>
+    <td>Ctrl+Backspace</td>
+   </tr>
+ </tbody>
+ </table>
+
 <h2 id="help_window_shortcuts">Help Window Shortcuts</h2>
 
 <p>These shortcuts are available from Help windows.</p>
 
 <table class="defaultTable">
 <colgroup>
   <col class="commandColumn"></col>
   <col class="osFirstColumn"></col>
--- a/suite/locales/en-US/chrome/common/help/shortcuts_navigator.xhtml
+++ b/suite/locales/en-US/chrome/common/help/shortcuts_navigator.xhtml
@@ -276,22 +276,16 @@
     <td>Up Arrow</td>
   </tr>
   <tr>
     <td>Go Down One Line</td>
     <td>Down Arrow</td>
     <td>Down Arrow</td>
     <td>Down Arrow</td>
   </tr>
-  <tr>
-    <td>Turn on/off Caret Mode</td>
-    <td>F7</td>
-    <td>F7 (if F7 is not programmed for another command)</td>
-    <td>F7</td>
-  </tr>
 </tbody>
 </table>
 
 <h2 id="page_viewing_shortcuts">Page Viewing Shortcuts</h2>
 
 <table class="defaultTable">
 <colgroup>
   <col class="commandColumn"></col>
--- a/suite/locales/en-US/chrome/common/help/suite-toc.rdf
+++ b/suite/locales/en-US/chrome/common/help/suite-toc.rdf
@@ -1131,16 +1131,17 @@
 </rdf:Description>
 
 <!-- KEYBOARD SHORTCUTS CONTENT STARTS -->
 <rdf:Description about="#shortcuts">
     <nc:subheadings>
       <rdf:Seq>
         <rdf:li><rdf:Description ID="shortcuts_using" nc:name="Using Shortcuts" nc:link="shortcuts.xhtml#using_shortcuts"/> </rdf:li>
         <rdf:li><rdf:Description ID="shortcuts_general" nc:name="General &brandShortName; Shortcuts" nc:link="shortcuts.xhtml#general_mozilla_shortcuts"/> </rdf:li>
+        <rdf:li><rdf:Description ID="shortcuts-text-field" nc:name="Text Field Shortcuts" nc:link="shortcuts.xhtml#text_field_shortcuts"/> </rdf:li>
         <rdf:li><rdf:Description ID="shortcuts_navigator" nc:name="Browser Shortcuts" nc:link="shortcuts_navigator.xhtml"/> </rdf:li>
         <rdf:li><rdf:Description ID="shortcuts_mail" nc:name="Mail &amp; Newsgroups Shortcuts" nc:link="shortcuts_mailnews.xhtml"/> </rdf:li>
         <rdf:li><rdf:Description ID="shortcuts_composer" nc:name="Composer Shortcuts" nc:link="shortcuts_composer.xhtml"/> </rdf:li>
         <rdf:li><rdf:Description ID="shortcuts_help" nc:name="Help Window Shortcuts" nc:link="shortcuts.xhtml#help_window_shortcuts"/> </rdf:li>
       </rdf:Seq>
     </nc:subheadings>
   </rdf:Description>