Fix some more typos and errors in the documentation

common/locale/en-US/buffer.xml

@@ -12,7 +12,7 @@
 <toc start="2"/>
 
 <p>
-    A buffer the container that holds the given web page, including
+    Buffer is a container that holds the given web page, including
     all of its history and frames. Each tab contains exactly one
     buffer, and for most purposes the two terms are interchangeable.
     See <t>tabs</t> for more.

common/locale/en-US/developer.xml

@@ -39,7 +39,7 @@
     creates a new help section for the command <ex>:help</ex> and for
     the related key binding, <k name="F1"/>. It also creates help tags
     for the command, its shortcuts, the key binding, and the general
-    topic, ‘help’. These tags enable linking to this section when from
+    topic, ‘help’. These tags enable linking to this section from
     other mentions of the topic and from the <ex>:help</ex> command.
 </p>
 
@@ -76,7 +76,7 @@
     <dt>&tab;spec</dt>  <dd>The specification for this item, such as an example command-line. (HelpSpec)</dd>
     <dt>&tab;strut</dt> <dd>A horizontal formatting strut which ensures that all previous &lt;tags> and &lt;spec> elements appear above the ones that follow.</dd>
     <dt>&tab;type</dt>  <dd>For options, the type of the option.
-                            <em>number</em>, <em>boolean</em>, <em>string</em>, <em>string</em>, <em>stringlist</em>, or <em>charlist</em>.
+                            <em>number</em>, <em>boolean</em>, <em>string</em>, <em>stringlist</em>, or <em>charlist</em>.
                             (HelpType)
                         </dd>
     <dt>&tab;default</dt>     <dd>For options, the default value. (HelpDefault)</dd>
@@ -152,7 +152,7 @@
     there is no need to write <str>load</str> event handlers. Beyond
     that, what you may do with your plugins is practically limitless.
     Plugins have full access to all of the chrome resources that
-    ordinary &dactyl.host; do, along with the entire power of the
+    ordinary &dactyl.host; does, along with the entire power of the
     &dactyl.appname; API. If you need a starting point, have a look at some
     <link topic="&dactyl.plugins;">existing plugins</link> or
     <link topic="http://addon.mozilla.org/">extensions</link>,

common/locale/en-US/gui.xml

@@ -16,7 +16,7 @@
     Although &dactyl.appname; offers access to the most frequently used
     &dactyl.host; functionality via Ex and Normal mode commands, there may be
     times when direct access to the &dactyl.host; GUI is required. For such
-    eventualities, there there are commands to access menu items and to launch
+    eventualities, there are commands to access menu items and to launch
     standard &dactyl.host; dialogs.
 </p>
 
@@ -48,7 +48,7 @@
         <p>
             Opens the &dactyl.host; addon manager, where extensions and themes
             may be installed, removed, disabled, and configured. See also
-            <ex>:extenstions</ex>, <ex>:extinstall</ex>, <ex>:extoptions</ex>,
+            <ex>:extensions</ex>, <ex>:extinstall</ex>, <ex>:extoptions</ex>,
             <ex>:extenable</ex>, <ex>:extdisable</ex>, and <ex>:extdelete</ex>.
         </p>
     </description>
@@ -59,10 +59,10 @@
     <tags>:dia :dialog</tags>
     <spec>:dia<oa>log</oa> <oa>&dactyl.host;-dialog</oa></spec>
     <description>
-        <p>Open a &dactyl.host; dialog. Available dialogs include,</p>
+        <p>Open a &dactyl.host; dialog. Available dialogs include:</p>
 
         <dl tag="dialog-list">
-            <dt>about</dt>           <dd>About Mozilla &dactyl.host;;</dd>
+            <dt>about</dt>           <dd>About Mozilla &dactyl.host;</dd>
             <dt>addbookmark</dt>     <dd>Add bookmark for the current page</dd>
             <dt>addons</dt>          <dd>Manage Add-ons</dd>
             <dt>bookmarks</dt>       <dd>List your bookmarks</dd>
@@ -221,7 +221,7 @@
 
 <ul>
     <li>
-        <em>URL</em>: The URL of the currently loaded page. While the page is loading
+        <em>URL</em>: The URL of the currently loaded page. While the page is loading,
         progress messages are also output to this field.
     </li>
     <li>

common/locale/en-US/hints.xml

@@ -42,16 +42,16 @@
         <dl>
             <dt><k name="Return"/></dt>
             <dd>Selects the first highlighted element, or that
-                fucused by <k name="Tab"/>.</dd>
+                focused by <k name="Tab"/>.</dd>
 
             <dt><k name="Tab"/></dt>
             <dd>Moves the focus to the next hintable element</dd>
 
             <dt><k name="Leader"/></dt>
-            <dd>Temporarilly treats all numbers as ordinary text</dd>
+            <dd>Temporarily treats all numbers as ordinary text</dd>
 
             <dt><k name="Esc"/></dt>
-            <dd>Exitts hint mode without selecting an element</dd>
+            <dd>Exits hint mode without selecting an element</dd>
         </dl>
     </description>
 </item>
@@ -85,7 +85,7 @@
             exactly like <t>QuickHint</t> mode, except that each
             sub-mode highlights a more specialized set of elements,
             and performs a unique action on the selected link.
-            Because of the panoply of extend hint modes available,
+            Because of the panoply of extended hint modes available,
             after pressing <k>;</k>, pressing <k name="Tab"/> brings
             up the <k>completion-list</k> with a list of each hint
             mode and its description.
@@ -94,7 +94,7 @@
         <p><a>mode</a> may be one of:</p>
 
         <ul>
-            <li tag=";;"><em>;</em> to focus a link and hover it with the mouse</li>
+            <li tag=";;"><em>;</em> to focus a link</li>
             <li tag=";?"><em>?</em> to show information about the element (incomplete)</li>
             <li tag=";s"><em>s</em> to save its destination</li>
             <li tag=";a"><em>a</em> to save its destination (prompting for save location)</li>
@@ -121,7 +121,7 @@
            -->
         <p>
             Of the previous modes, the value of the <o>hinttags</o>
-            option os used to choose the highlighted elements for
+            option is used to choose the highlighted elements for
             the modes, <k>;;</k>, <k>;?</k>, <k>;w</k>, <k>;v</k>,
             <k>;V</k>, <k>;Y</k> and <k>;c</k>. The value of
             <o>extendedhinttags</o> is used to choose the elements

common/locale/en-US/map.xml

@@ -12,9 +12,9 @@
 <toc start="2"/>
 
 <p>
-    &dactyl.appname; provides a number commands to change the
+    &dactyl.appname; provides a number of commands to change the
     behavior of key presses. This can mean anything from
-    automatically substituting one key for another, to automatically
+    automatically substituting one key for another or automatically
     replacing one typed word for another, to launching a dialog or
     running a command.
 </p>
@@ -67,7 +67,7 @@
 <warning>
     It is important to note that mappings are <em>not</em>
     automatically saved between sessions. In order to preserve them,
-    they must either be added to your <tt>&dactyl.name;rc</tt> or
+    they must either be added to your <t>&dactyl.name;rc</t> or
     saved via the <ex>:mk&dactyl.name;rc</ex> command.
 </warning>
 
@@ -110,7 +110,7 @@
     <dt></dt> <dd></dd>
 
     <dt>-builtin</dt> <dd>Execute this mapping as if there were no user-defined mappings (short name <em>-b</em>)</dd>
-    <dt>-descripion</dt> <dd>A discription of this mapping (short name <em>-d</em>)</dd>
+    <dt>-descripion</dt> <dd>A description of this mapping (short name <em>-d</em>)</dd>
     <dt>-ex</dt> <dd>Execute <a>rhs</a> as an Ex command rather than keys (short name <em>-e</em>)</dd>
     <dt>-javascript</dt> <dd>Execute <a>rhs</a> as JavaScript rather than keys (short names <em>-js</em>, <em>-j</em>)</dd>
     <dt>-modes</dt> <dd>Create this mapping in the given modes (short names <em>-mode</em>, <em>-m</em>)</dd>
@@ -312,7 +312,7 @@
     <dd>Type the ‘2’ while holding the ‘Control’ key.</dd>
 
     <dt><k name="C-@"/></dt>
-    <dd>Type the ‘2’ key @ while holding the ‘Control’ key.</dd>
+    <dd>Type the ‘@’ key while holding the ‘Control’ key.</dd>
 
     <dt><k name="S-Space"/></dt>
     <dd>Press the space bar while holding the ‘Shift’ key.</dd>
@@ -585,7 +585,7 @@
         <h3 tag="E175 E176 :command-nargs">Argument handling</h3>
 
         <p>
-            By default user commands accept no arguments. This can be changed by specifying
+            By default, user commands accept no arguments. This can be changed by specifying
             the -nargs attribute.
         </p>
 
@@ -602,7 +602,7 @@
         <h3 tag="E180 E181 :command-complete">Argument completion</h3>
 
         <p>
-            Completion for arguments to user defined commands is not available by default.
+            Completion for arguments to user-defined commands is not available by default.
             Completion can be enabled by specifying one of the following arguments to the
             -complete option when defining the command.
         </p>
@@ -646,7 +646,7 @@
 
         <p>
             <em>start</em> is the index into the word being completed at which the returned values
-            should be applied and <em>completions</em> is a two dimensional array of the form:
+            should be applied and <em>completions</em> is a two-dimensional array of the form:
             [[arg1, description1], [arg2, description2], …]
         </p>
 
@@ -655,7 +655,7 @@
         <h3 tag="E177 E178 :command-count">Count handling</h3>
 
         <p>
-            By default user commands do not accept a count. Use the -count attribute if
+            By default, user commands do not accept a count. Use the -count attribute if
             you'd like to have a count passed to your user command. This will then be
             available for expansion as &lt;count> in the argument.
         </p>
@@ -663,7 +663,7 @@
         <h3 tag=":command-bang">Special cases</h3>
 
         <p>
-            By default a user command does not have a special version, i.e. a version
+            By default, a user command does not have a special version, i.e. a version
             executed with the ! modifier. Providing the -bang attribute will enable this
             and &lt;bang> will be available in the argument.
         </p>

common/locale/en-US/marks.xml

@@ -18,7 +18,7 @@
 
 <ul>
     <li><em>Bookmarks</em> are the standard marks of &dactyl.host;, and are fully supported.</li>
-    <li><em>QuickMarks</em> allow you to quickly save and return as many as 62 (a-zA-Z0-9) different web sites with a quick keyboard shortcut.</li>
+    <li><em>QuickMarks</em> allow you to quickly save and return to as many as 62 (a-zA-Z0-9) different web sites with a quick keyboard shortcut.</li>
     <li><em>Local marks</em> allow you to store and return to a position within the current web page.</li>
     <li><em>URL marks</em> allow you to store and return to the position and URL of the current web page.</li>
     <li><em>History</em> marks every opened page with data on when and how often it has been visited.</li>
@@ -70,7 +70,7 @@
         </dl>
 
         <p>
-            If <oa>url</oa> is omitted, the URL currently loaded web
+            If <oa>url</oa> is omitted, URL of the currently loaded web
             page is used.
         </p>
 
@@ -113,7 +113,7 @@
 
         <p>
             The special version <ex>:bmarks!</ex> works the same as
-            <ex>:bmarks</ex> except that it opens all all matching
+            <ex>:bmarks</ex> except that it opens all matching
             bookmarks in new tabs rather than listing them.
         </p>
 
@@ -158,7 +158,7 @@
     when and how often it is visited, and can be retrieved both in
     history list and location completions. Indeed, the ‘frecency’
     algorithm used to determine the results of location completions
-    (see the <o>complete</o> option) mean that history is often a
+    (see the <o>complete</o> option) means that history is often a
     more effective type of mark than bookmarks themselves.
 </p>
 
@@ -252,7 +252,7 @@
 
         <p>
             The special version <ex>:history!</ex> works the same as
-            <ex>:history</ex> except that it opens all all matching
+            <ex>:history</ex> except that it opens all matching
             pages in new tabs rather than listing them.
         </p>
 

common/locale/en-US/pattern.xml

@@ -105,7 +105,7 @@
     <tags>*</tags>
     <spec>*</spec>
     <description short="true">
-        <p>Search forward for the next word under the cursor.</p>
+        <p>Search forward for the next occurence of the word under cursor.</p>
     </description>
 </item>
 
@@ -114,7 +114,7 @@
     <tags>#</tags>
     <spec>#</spec>
     <description short="true">
-        <p>Search backward for the previous word under the cursor.</p>
+        <p>Search backward for the previous occurence of the word under cursor.</p>
     </description>
 </item>
 

common/locale/en-US/repeat.xml

@@ -13,7 +13,7 @@
 
 <p>
     &dactyl.appname; can repeat commands in a number of ways, from repeating
-    the last command, to recording and playing macros, to saving its state and
+    the last command, recording and playing macros, to saving its state and
     executing scripts.
 </p>
 
@@ -117,7 +117,7 @@
     <description>
         <p>
             Read Ex commands, JavaScript, or CSS from <a>file</a>. Files are
-            interpreted based on their extensions. Files when end in
+            interpreted based on their extensions. Files which end in
             <em>.js</em> are executed as JavaScript, while those ending in
             <em>.css</em> are loaded as Cascading Stylesheets, and anything
             else is interpreted as Ex commands. In normal cases, any errors
@@ -140,7 +140,7 @@
             page and every chrome document, including all browser windows and
             dialogs. If the same file is sourced more than once, its previous
             rules are cleared before it is applied again. Rules can be
-            restricted to specific documents by enclosing them
+            restricted to specific documents by enclosing them inside
             <link topic="https://developer.mozilla.org/en/CSS/@-moz-document">@-moz-document</link>
             blocks.
         </p>
@@ -150,7 +150,7 @@
         <p>
             JavaScript files are executed with full chrome privileges in their
             own global namespaces. These namespaces are stored as objects in
-            the <em>plugins</em> object, in the property named for the full
+            the <em>plugins</em> object, in the property named after the full
             path of the sourced file. This means that any variables or
             functions created by your script are stored as properties of that
             object. Additionally, all properties of the global <em>window</em>
@@ -213,7 +213,7 @@
         <p>
             Source the specified file from the first directory in
             <o>runtimepath</o> in which it exists. When <oa>!</oa> is given,
-            source the specified from all directories in <o>runtimepath</o> in
+            source the file from all directories in <o>runtimepath</o> in
             which it exists.
         </p>
         <example><ex>:runtime plugins/foobar.js</ex></example>

common/locale/en-US/styling.xml

@@ -148,7 +148,7 @@
     <spec>:sty<oa>le</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-append</oa> <a>filter</a> <oa>css</oa></spec>
     <description>
         <p>
-            Add CSS styles to the browser or to web pages. <a>filter</a> is a comma separated
+            Add CSS styles to the browser or to web pages. <a>filter</a> is a comma-separated
             list of URLs to match. URLs ending with <em>*</em> are matched as prefixes, URLs not
             containing any <em>:</em> or <em>/</em> characters are matched as domains. <oa>css</oa> is a full
             CSS rule set (e.g., <tt>body { color: blue; }</tt>).

common/locale/en-US/tabs.xml

@@ -15,7 +15,7 @@
     Tabs allow you to keep many web pages open at the same time and to quickly
     switch between them. Each tab contains exactly one buffer. If your version
     of &dactyl.host; supports tab groups, only buffers in the active group
-    will be attached to visible tabs. Though all buffers may not always be
+    will be attached to visible tabs. Although not all buffers are always
     attached to visible tabs, they are all always accessible via the
     buffer-centric commands and key bindings. Tab-centric commands and key
     bindings, however, only operate on the set of visible tabs.
@@ -134,8 +134,8 @@
     <spec><oa>count</oa>gt</spec>
     <description>
         <p>
-            Go to the next tab. Cycles to the first tab when the last is selected.
+            Go to the next tab. Cycles to the first tab when the last one is selected.
-            If <oa>count</oa> is specified go to the <oa>count</oa>th tab.
+            If <oa>count</oa> is specified, go to the <oa>count</oa>th tab.
         </p>
     </description>
 </item>
@@ -147,8 +147,8 @@
     <spec><oa>count</oa>&lt;C-n></spec>
     <description>
         <p>
-            Go to the next tab. Cycles to the first tab when the last is selected.
+            Go to the next tab. Cycles to the first tab when the last one is selected.
-            If <oa>count</oa> is specified go to the <oa>count</oa>th next tab.
+            If <oa>count</oa> is specified, go to the <oa>count</oa>th next tab.
         </p>
     </description>
 </item>
@@ -160,8 +160,8 @@
     <spec><oa>count</oa>gT</spec>
     <description>
         <p>
-            Go to the previous tab. Cycles to the last tab when the first is selected.
+            Go to the previous tab. Cycles to the last tab when the first one is selected.
-            If <oa>count</oa> is specified go to the <oa>count</oa>th previous tab.
+            If <oa>count</oa> is specified, go to the <oa>count</oa>th previous tab.
         </p>
     </description>
 </item>
@@ -176,8 +176,8 @@
     <spec>:<oa>count</oa>bn<oa>ext</oa> <oa>count</oa></spec>
     <description>
         <p>
-            Switch to the next or <oa>count</oa>th tab. Cycles to the first tab when the last is
+            Switch to the next or <oa>count</oa>th tab. Cycles to the first tab when
-            selected and <oa>count</oa> is not specified.
+            the last one is selected and <oa>count</oa> is not specified.
         </p>
     </description>
 </item>
@@ -234,7 +234,7 @@
 
         <p>If argument is <em>#</em>, the alternate buffer will be selected (see <k name="C-^"/>).</p>
 
-        <p>If no argument is given the current buffer remains current.</p>
+        <p>If no argument is given, the current buffer remains current.</p>
     </description>
 </item>
 

pentadactyl/locale/en-US/autocommands.xml

@@ -17,7 +17,7 @@
     <dt>PageLoadPre</dt>       <dd>Triggered after a page load is initiated</dd>
     <dt>PageLoad</dt>          <dd>Triggered when a page gets (re)loaded/opened</dd>
     <dt>PrivateMode</dt>       <dd>Triggered when private mode is activated or deactivated</dd>
-    <dt>Sanitize</dt>	       <dd>Triggered when privata data are sanitized</dd>
+    <dt>Sanitize</dt>          <dd>Triggered when private data are sanitized</dd>
     <dt>ShellCmdPost</dt>      <dd>Triggered after executing a shell command with <ex>:!</ex><a>cmd</a></dd>
     <dt>Enter</dt>             <dd>Triggered after &dactyl.host; starts</dd>
     <dt>LeavePre</dt>          <dd>Triggered before exiting &dactyl.host;, just before destroying each module</dd>

pentadactyl/locale/en-US/intro.xml

@@ -25,12 +25,12 @@
     If this is your first time running &dactyl.appname;, you may need some
     time to adjust to the standard interface, which hides the menu,
     navigation, and tool bars by default. If you find it uncomfortable to work
-    without them, you can re-enable them by typing,
+    without them, you can re-enable them by typing
 </p>
 <code><ex>:set</ex> <link topic="'guioptions'"><hl key="HelpOpt">guioptions</hl></link><hl key="HelpEx">+=mT</hl><k name="Return"/></code>
 <p>
     If you have trouble remembering commands or keyboard shortcuts, you can
-    bring up this help page at any time by typing <ex>:help</ex> or the
+    bring up this help page at any time by typing <ex>:help</ex> or
     <k name="F1"/>. If you find that you don't like &dactyl.appname; at all,
     you can disable it by typing <ex>:extdisable &dactyl.appname;</ex> or
     delete it entirely by typing <ex>:extdelete &dactyl.appname;</ex>
@@ -147,12 +147,12 @@
 <ul>
     <li>Vim-like keybindings (<k>h</k>, <k>j</k>, <k>gg</k>, <k>ZZ</k>, <k name="C-f"/>, etc.)</li>
     <li>Ex commands (<ex>:quit</ex>, <ex>:open www.foo.com</ex>, …)</li>
-    <li>Tab completion for all commands, highliy configurable via <o>wildmode</o> and <o>wildoptions</o></li>
+    <li>Tab completion for all commands, highly configurable via <o>wildmode</o> and <o>wildoptions</o></li>
     <li>Hit-a-hint like navigation of links (start with <k>f</k> to follow a link)</li>
     <li>Advanced completion of bookmark and history URLs</li>
     <li>Vim-like status line with a Wget-like progress bar</li>
     <li>Minimal GUI (easily hide superfluous menubar and toolbar with <ex>:set guioptions=</ex>)</li>
-    <li>Ability to <ex>:source</ex> JavaScript, CSS, and &dactyl.appname; command files.</li>
+    <li>Ability to <ex>:source</ex> JavaScript, CSS, and &dactyl.appname; command files</li>
     <li>Easy quick searches (see <ex>:open</ex>)</li>
     <li>Count supported for many commands (<em>3</em><k name="C-o"/> will go back 3 pages)</li>
     <li>Visual bell for errors (<o>visualbell</o>)</li>

pentadactyl/locale/en-US/tutorial.xml

@@ -13,7 +13,7 @@
 <h1 tag="tutorial">Quick-start tutorial</h1>
 
 <html:p style="text-align: center">
-    This is a quickstart tutorial to help get new users up and running
+    This is a quickstart tutorial to help new users get up and running
     in &dactyl.appname;. It is not intended as a full reference explaining all
     features.
 </html:p>
@@ -26,17 +26,17 @@
     regain these by issuing the command
 </p>
 
-<code><ex>:set go+=mTB<key name="CR"/></ex></code>
+<code><ex>:set go+=mTB<k name="CR"/></ex></code>
 
 <p>
-    where <k name="CR"/> represents pressing the <key name="Enter"/> or <key name="Return"/> key.
+    where <k name="CR"/> represents pressing the <k name="Enter"/> or <k name="Return"/> key.
     If you're a veteran Vim user, this may look familiar. It should.
 </p>
 
 <p>
     However, in this author's opinion, the best way to get familiar with
     &dactyl.appname; is to leave these disabled for now. (The above action can be
-    reversed with <ex>:set go=<key name="CR"/></ex>) You can look at the entry for <o>guioptions</o> in
+    reversed with <ex>:set go=<k name="CR"/></ex>) You can look at the entry for <o>guioptions</o> in
     <t>options</t> for more information on this.
 </p>
 
@@ -70,13 +70,13 @@
 
 <p>
     Vim is a great editor but it's not much of a web browser. So even seasoned Vim
-    users will probably have to look at &dactyl.appname; documentation sooner or later.
+    users will probably have to look at &dactyl.appname;'s documentation sooner or later.
     Most of the documentation for &dactyl.appname;'s features are easily found using the
     <ex>:help</ex> command. For example, you can find help on the <ex>:help</ex> command
     by typing
 </p>
 
-<code><ex>:help :help<key name="CR"/></ex></code>
+<code><ex>:help :help<k name="CR"/></ex></code>
 
 <p>
     Similarly, help on configurable options is available with
@@ -90,8 +90,8 @@
 </p>
 
 <code>
-<ex>:help gt<key name="CR"/></ex>
+<ex>:help gt<k name="CR"/></ex>
-<ex>:help gT<key name="CR"/></ex>
+<ex>:help gT<k name="CR"/></ex>
 </code>
 
 <p>
@@ -192,11 +192,11 @@
 </p>
 
 <code>
-<ex>:open my.webmail.com<key name="CR"/></ex>
+<ex>:open my.webmail.com<k name="CR"/></ex>
-<k>o</k>my.webmail.com<key name="CR"/>
+<k>o</k>my.webmail.com<k name="CR"/>
 
-<ex>:tabopen google.com<key name="CR"/></ex>
+<ex>:tabopen google.com<k name="CR"/></ex>
-<k>t</k>google.com<key name="CR"/>
+<k>t</k>google.com<k name="CR"/>
 </code>
 
 <h2 tag="hints-tutorial">Some hints about surfing…</h2>
@@ -269,7 +269,7 @@
 
 <p>
     To save your current settings and allow them to be loaded automatically
-    next time you start &dactyl.appname;, issue the <ex>:mkv</ex> command.
+    next time you start &dactyl.appname;, issue the <ex>:mkp</ex> command.
 </p>
 
 <p>
@@ -339,7 +339,7 @@
     Feel free to explore at this point. If you use the <ex>:tabopen</ex> command,
     remember to use the <k>gt</k>/<k>gT</k> mappings to get back to this page. If
     using the <ex>:open</ex> command, use the history keys (e.g., <k>H</k>) to return.
-    If you get hopelessly lost, just type <ex>:help<key name="CR"/></ex> and click the
+    If you get hopelessly lost, just type <ex>:help<k name="CR"/></ex> and click the
     <em>Tutorial</em> link to return.
 </p>