Major documentation updates and formatting fixes, and many, many other changes thanks to an MQ glitch, including:

* Significant completion speed improvements * Significantly improve startup speed, in large part by lazily instantiating Options and Commands, lazily installing highlight stylesheets, etc. * Update logos and icons, fix atrocious about page * Fix Teledactyl * JavaScript completion now avoids accessing property values * Add Option#persist to define which options are saved with :mkp * Add new Dactyl component which holds add-on-specific configuration information and removes need for separate components for each dactyl host * Several fixes for latest nightlies * Significant code cleanup and many bug fixes --HG-- rename : muttator/AUTHORS => teledactyl/AUTHORS rename : muttator/Donors => teledactyl/Donors rename : muttator/Makefile => teledactyl/Makefile rename : muttator/NEWS => teledactyl/NEWS rename : muttator/TODO => teledactyl/TODO rename : muttator/chrome.manifest => teledactyl/chrome.manifest rename : muttator/components/commandline-handler.js => teledactyl/components/commandline-handler.js rename : muttator/components/protocols.js => teledactyl/components/protocols.js rename : muttator/content/addressbook.js => teledactyl/content/addressbook.js rename : muttator/content/compose/compose.js => teledactyl/content/compose/compose.js rename : muttator/content/compose/compose.xul => teledactyl/content/compose/compose.xul rename : muttator/content/compose/dactyl.dtd => teledactyl/content/compose/dactyl.dtd rename : muttator/content/compose/dactyl.xul => teledactyl/content/compose/dactyl.xul rename : muttator/content/config.js => teledactyl/content/config.js rename : muttator/content/dactyl.dtd => teledactyl/content/dactyl.dtd rename : muttator/content/logo.png => teledactyl/content/logo.png rename : muttator/content/mail.js => teledactyl/content/mail.js rename : muttator/content/muttator.xul => teledactyl/content/pentadactyl.xul rename : muttator/contrib/vim/Makefile => teledactyl/contrib/vim/Makefile rename : muttator/contrib/vim/ftdetect/muttator.vim => teledactyl/contrib/vim/ftdetect/muttator.vim rename : muttator/contrib/vim/mkvimball.txt => teledactyl/contrib/vim/mkvimball.txt rename : muttator/contrib/vim/syntax/muttator.vim => teledactyl/contrib/vim/syntax/muttator.vim rename : muttator/install.rdf => teledactyl/install.rdf rename : muttator/locale/en-US/Makefile => teledactyl/locale/en-US/Makefile rename : muttator/locale/en-US/all.xml => teledactyl/locale/en-US/all.xml rename : muttator/locale/en-US/autocommands.xml => teledactyl/locale/en-US/autocommands.xml rename : muttator/locale/en-US/gui.xml => teledactyl/locale/en-US/gui.xml rename : muttator/locale/en-US/intro.xml => teledactyl/locale/en-US/intro.xml rename : muttator/skin/icon.png => teledactyl/skin/icon.png
2026-02-19 22:15:46 +01:00 · 2010-09-17 06:21:33 -04:00
parent bfbb4b1313
commit 1557b70f45
125 changed files with 4409 additions and 3969 deletions
--- a/common/locale/en-US/buffer.xml
+++ b/common/locale/en-US/buffer.xml
@@ -6,23 +6,29 @@
 <document
    name="buffer"
    title="&dactyl.appname; Buffer"
-    xmlns="http://vimperator.org/namespaces/liberator"
-    xmlns:html="http://www.w3.org/1999/xhtml">
+    xmlns="&xmlns.dactyl;"
+    xmlns:html="&xmlns.html;">
 <h1 tag="buffer document">Buffer</h1>
 <toc start="2"/>

-&dactyl.appname; holds exactly one buffer object for each tab. It is usually an
-(X)HTML document with advanced features.
+<p>
+    A buffer the 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 interchangable.
+    See <t>tabs</t> for more.
+</p>

 <h2 tag="buffer-information">Buffer information</h2>

 <item>
    <tags><![CDATA[<C-g>]]></tags>
+    <strut/>
    <spec>&lt;C-g></spec>
    <description>
        <p>
-            Print the current file name. Also shows some additional file information like
-            file size or the last modified date.
+            Print the current file name along with basic page
+            information including last modification time, the number
+            of feeds present, and the page title.
        </p>
    </description>
 </item>
@@ -31,7 +37,7 @@
 <item>
    <tags><![CDATA[g<C-g>]]></tags>
    <spec>g&lt;C-g></spec>
-    <description>
+    <description short="true">
        <p>Print file information. Same as <ex>:pa<oa>geinfo</oa></ex>.</p>
    </description>
 </item>
@@ -39,15 +45,20 @@

 <item>
    <tags>:pa :pageinfo</tags>
-    <spec>:pa<oa>geinfo</oa></spec>
+    <spec>:pa<oa>geinfo</oa> <oa>items</oa></spec>
    <description>
-        <p>Show various page information. See <ex>:help <o>pageinfo</o></ex> for available options.</p>
+        <p>
+            Show various page information. The information provided
+            is determined by the value of <o>pageinfo</o>, or
+            <oa>items</oa> if present.
+        </p>
    </description>
 </item>


 <item>
    <tags>gf</tags>
+    <strut/>
    <spec>gf</spec>
    <description>
        <p>
@@ -60,12 +71,15 @@

 <item>
    <tags>gF</tags>
+    <strut/>
    <spec>gF</spec>
    <description>
        <p>
-            View source with an external editor. Opens the source code of the current web
-            site with the external editor specified by the <o>editor</o> option. For now the
-            external editor must be able to download and open files from a remote URL.
+            View source with an external editor. Opens the source
+            code of the current web site with the external editor
+            specified by the <o>editor</o> option. The external
+            editor must be able to download and open files from a
+            remote URL.
        </p>
    </description>
 </item>
@@ -76,8 +90,9 @@
    <spec>:vie<oa>wsource</oa><oa>!</oa> <oa>url</oa></spec>
    <description>
        <p>
-            View source code of current document. If <oa>url</oa> is specified then view the
-            source of that document. When <oa>!</oa> is given, it is opened with the external
+            View source code of current document. If <oa>url</oa> is
+            specified then view the source of that document. When
+            <oa>!</oa> is given, it is opened with the external
            editor.
        </p>
    </description>
@@ -88,11 +103,12 @@

 <item>
    <tags>^ 0</tags>
+    <strut/>
    <spec>0</spec>
    <description>
        <p>
-            Scroll to the absolute left of the document. Unlike in Vim, <k>0</k> and <k>^</k>
-            work exactly the same way.
+            Scroll to the absolute left of the document. Unlike in
+            Vim, <k>0</k> and <k>^</k> work exactly the same way.
        </p>
    </description>
 </item>
@@ -101,7 +117,7 @@
 <item>
    <tags>$</tags>
    <spec>$</spec>
-    <description>
+    <description short="true">
        <p>Scroll to the absolute right of the document</p>
    </description>
 </item>
@@ -109,11 +125,13 @@

 <item>
    <tags><![CDATA[<Home> gg]]></tags>
+    <strut/>
    <spec><oa>count</oa>gg</spec>
    <description>
        <p>
-            Go to the top of the document. When used with <oa>count</oa> like in <k>35gg</k>, it
-            scrolls to 35% of the document.
+            Go to the top of the document. With <oa>count</oa>,
+            scroll vertically to <oa>count</oa> percent of the
+            document.
        </p>
    </description>
 </item>
@@ -121,11 +139,12 @@

 <item>
    <tags><![CDATA[<End> G]]></tags>
+    <strut/>
    <spec><oa>count</oa>G</spec>
    <description>
        <p>
-            Go to the end of the document. When used with <oa>count</oa> like in <k>35G</k>, it
-            scrolls to 35% of the document.
+            Go to the end of the document. With <oa>count</oa>,
+            behaves exactly the same as <oa>gg</oa>.
        </p>
    </description>
 </item>
@@ -134,7 +153,7 @@
 <item>
    <tags>N%</tags>
    <spec><a>count</a>%</spec>
-    <description>
+    <description short="true">
        <p>Scroll to <a>count</a> percent of the document.</p>
    </description>
 </item>
@@ -142,15 +161,12 @@

 <item>
    <tags><![CDATA[<Left> h]]></tags>
+    <strut/>
    <spec><oa>count</oa>h</spec>
    <description>
        <p>
-            Scroll document to the left. If <oa>count</oa> is specified then move <oa>count</oa> times as
-            much to the left.
-        </p>
-        <p>
-            If the document cannot scroll more, a beep is emitted (unless <o>visualbell</o> is
-            set).
+            Scroll document to the left. If <oa>count</oa> is specified,
+            repeat <oa>count</oa> times.
        </p>
    </description>
 </item>
@@ -158,15 +174,12 @@

 <item>
    <tags><![CDATA[<C-e> <Down> j]]></tags>
+    <strut/>
    <spec><oa>count</oa>j</spec>
    <description>
        <p>
-            Scroll document down. If <oa>count</oa> is specified then move <oa>count</oa> times as much
-            down.
-        </p>
-        <p>
-            If the document cannot scroll more, a beep is emitted (unless <o>visualbell</o> is
-            set).
+            Scroll document to the down. If <oa>count</oa> is specified,
+            repeat <oa>count</oa> times.
        </p>
    </description>
 </item>
@@ -174,14 +187,12 @@

 <item>
    <tags><![CDATA[<C-y> <Up> k]]></tags>
+    <strut/>
    <spec><oa>count</oa>k</spec>
    <description>
        <p>
-            Scroll document up. If <oa>count</oa> is specified then move <oa>count</oa> times as much up.
-        </p>
-        <p>
-            If the document cannot scroll more, a beep is emitted (unless <o>visualbell</o> is
-            set).
+            Scroll document to the up. If <oa>count</oa> is specified,
+            repeat <oa>count</oa> times.
        </p>
    </description>
 </item>
@@ -189,15 +200,12 @@

 <item>
    <tags><![CDATA[<Right> l]]></tags>
+    <strut/>
    <spec><oa>count</oa>l</spec>
    <description>
        <p>
-            Scroll document to the right. If <oa>count</oa> is specified then move <oa>count</oa> times
-            as much to the right.
-        </p>
-        <p>
-            If the document cannot scroll more, a beep is emitted (unless <o>visualbell</o> is
-            set).
+            Scroll document to the right. If <oa>count</oa> is specified,
+            repeat <oa>count</oa> times.
        </p>
    </description>
 </item>
@@ -205,12 +213,13 @@

 <item>
    <tags><![CDATA[<C-d>]]></tags>
+    <strut/>
    <spec><oa>count</oa>&lt;C-d></spec>
    <description>
        <p>
-            Scroll window downwards in the buffer. The number of lines is set by the
-            <o>scroll</o> option which defaults to half a page. If <oa>count</oa> is given <o>scroll</o> is
-            first set to this value.
+            Scroll window downwards by the amount specified in the
+            <o>scroll</o> option. With <oa>count</oa>, scroll as if
+            <o>scroll</o> were set to <o>count</o>.
        </p>
    </description>
 </item>
@@ -218,12 +227,13 @@

 <item>
    <tags><![CDATA[<C-u>]]></tags>
+    <strut/>
    <spec><oa>count</oa>&lt;C-u></spec>
    <description>
        <p>
-            Scroll window upwards in the buffer. The number of lines is set by the
-            <o>scroll</o> option which defaults to half a page. If <oa>count</oa> is given <o>scroll</o> is
-            first set to this value.
+            Scroll window upwards by the amount specified in the
+            <o>scroll</o> option. With <oa>count</oa>, scroll as if
+            <o>scroll</o> were set to <o>count</o>.
        </p>
    </description>
 </item>
@@ -231,18 +241,26 @@

 <item>
    <tags><![CDATA[<S-Space> <PageUp> <C-b>]]></tags>
+    <strut/>
    <spec><oa>count</oa>&lt;C-b></spec>
    <description>
-        <p>Scroll up a full page. Scroll window <oa>count</oa> pages Backwards (upwards) in the buffer.</p>
+        <p>
+            Scroll up a full page. With <oa>count</oa>, scroll up
+            <oa>count</oa> full pages.
+        </p>
    </description>
 </item>


 <item>
    <tags><![CDATA[<Space> <PageDown> <C-f>]]></tags>
+    <strut/>
    <spec><oa>count</oa>&lt;C-f></spec>
    <description>
-        <p>Scroll down a full page. Scroll window <oa>count</oa> pages Forwards (downwards) in the buffer.</p>
+        <p>
+            Scroll down a full page. With <oa>count</oa>, scroll
+            down <oa>count</oa> full pages.
+        </p>
    </description>
 </item>

@@ -252,7 +270,7 @@
 <item>
    <tags><![CDATA[<Tab>]]></tags>
    <spec>&lt;Tab></spec>
-    <description>
+    <description short="true">
        <p>Advance keyboard focus to the next element.</p>
    </description>
 </item>
@@ -261,7 +279,7 @@
 <item>
    <tags><![CDATA[<S-Tab>]]></tags>
    <spec>&lt;S-Tab></spec>
-    <description>
+    <description short="true">
        <p>Rewind keyboard focus to the previous element.</p>
    </description>
 </item>
@@ -269,12 +287,13 @@

 <item>
    <tags>gi</tags>
+    <strut/>
    <spec><oa>count</oa>gi</spec>
    <description>
        <p>
-            Focus last used input field. If there is no last input field, it focuses the
-            first input field. When used with <oa>count</oa> it directly jumps to the <oa>count</oa>th input
-            field.
+            Focus last used input field. If there is no last input
+            field, focus the first input field. With <oa>count</oa>,
+            focus the <oa>count</oa>th input field.
        </p>
    </description>
 </item>
@@ -282,11 +301,13 @@

 <item>
    <tags>]f</tags>
+    <strut/>
    <spec><oa>count</oa>]f</spec>
    <description>
        <p>
-            Focus next frame. Transfer keyboard focus to the <oa>count</oa>th next frame in
-            order. The newly focused frame is briefly colored red. Does not wrap.
+            Transfer keyboard focus to the <oa>count</oa>th next
+            frame. The newly focused frame is briefly highlighted
+            with <h>FrameIndicator</h>.
        </p>
    </description>
 </item>
@@ -294,11 +315,13 @@

 <item>
    <tags>[f</tags>
+    <strut/>
    <spec><oa>count</oa>[f</spec>
    <description>
        <p>
-            Focus previous frame. Transfer keyboard focus to the <oa>count</oa>th previous frame
-            in order. The newly focused frame is briefly colored red. Does not wrap.
+            Transfer keyboard focus to the <oa>count</oa>th next
+            previous frame. The newly focused frame is briefly highlighted
+            with <h>FrameIndicator</h>.
        </p>
    </description>
 </item>
@@ -306,13 +329,13 @@

 <item>
    <tags>]]</tags>
+    <strut/>
    <spec><oa>count</oa>]]</spec>
    <description>
        <p>
-            Follow the link labeled <str>next</str> or <str>></str>
-            if it exists. Useful when browsing forums or
-            documentation. Change <o>nextpattern</o> to modify its
-            behavior. It follows relations between files too.
+            Follow the last link matching <o>nextpattern</o>. Used,
+            for instance, to move to the next page of search
+            results.
        </p>
    </description>
 </item>
@@ -320,14 +343,13 @@

 <item>
    <tags>[[</tags>
+    <strut/>
    <spec><oa>count</oa>[[</spec>
    <description>
        <p>
-            Follow the link labeled <str>prev</str>,
-            <str>previous</str> or <str>&lt;</str> if it exists. Useful
-            when browsing forums or documentation. Change
-            <o>previouspattern</o> to modify its behavior. It
-            follows relations between files too.
+            Follow the last link matching <o>previouspattern</o>. Used,
+            for instance, to move to the previous page of search
+            results.
        </p>
    </description>
 </item>
@@ -335,31 +357,40 @@

 <h2 tag="zooming zoom">Zooming</h2>

-The zooming commands are dependent on two properties -- a zoom range and a
-series of levels within that range.
+<p>
+    The zooming commands are dependent on two properties—a zoom
+    range and a series of levels within that range.
+</p>

-The absolute value of the page zoom is limited to a value within the configured
-zoom range (default: 30%--300%). The zoom levels are used by
-<k>zi</k>/<k>zo</k>, and similar commands, to change the zoom value in steps. The
-default zoom levels are 30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%,
-170%, 200%, 240%, 300%.
+<p>
+    The absolute value of the page zoom is limited to a value within
+    the configured zoom range (default: 30%–300%). By default,
+    commands which zoom in or out select between the zoom levels,
+    30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%, 170%,
+    200%, 240%, 300%.
+</p>

-The available zoom range can be changed by setting the
-<link topic="http://kb.mozillazine.org/Zoom.minPercent">'zoom.minPercent'</link> and
-<link topic="http://kb.mozillazine.org/Zoom.maxPercent">'zoom.maxPercent'</link> &dactyl.host;
-preferences. The zoom levels can be changed using the
-<link topic="http://kb.mozillazine.org/Toolkit.zoomManager.zoomValues">'toolkit.ZoomManager.zoomLevels'</link>
-preference.
+<p>
+    The available zoom range can be changed by setting the
+    <pref>zoom.minPercent</pref>
+    and
+    <pref>zoom.maxPercent</pref>
+    &dactyl.host; preferences. The zoom levels can be changed using the
+    <pref>toolkit.zoomManager.zoomValues</pref>
+    preference.
+</p>

 <note>
-    'toolkit.ZoomManager.zoomLevels' is specified as a list of
-    values between 0 and 1, not as a percentage.
+    <pref>toolkit.zoomManager.zoomValues</pref> is specified as a
+    list of values between <em>0</em> and <em>1</em> rather than
+    percentages. For instance, <em>0.5</em> is equivalent to
+    <em>50%</em>.
 </note>

 <item>
    <tags>+ zi</tags>
    <spec><oa>count</oa>zi</spec>
-    <description>
+    <description short="true">
        <p>Enlarge text zoom of current web page. Mnemonic: zoom in.</p>
    </description>
 </item>
@@ -367,6 +398,7 @@ preference.

 <item>
    <tags>zm</tags>
+    <strut/>
    <spec><oa>count</oa>zm</spec>
    <description>
        <p>Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
@@ -377,7 +409,7 @@ preference.
 <item>
    <tags>- zo</tags>
    <spec><oa>count</oa>zo</spec>
-    <description>
+    <description short="true">
        <p>Reduce text zoom of current web page. Mnemonic: zoom out.</p>
    </description>
 </item>
@@ -386,7 +418,7 @@ preference.
 <item>
    <tags>zr</tags>
    <spec><oa>count</oa>zr</spec>
-    <description>
+    <description short="true">
        <p>Reduce text zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
    </description>
 </item>
@@ -394,11 +426,13 @@ preference.

 <item>
    <tags>zz</tags>
+    <strut/>
    <spec><oa>count</oa>zz</spec>
    <description>
        <p>
-            Set text zoom value of current web page. Zoom value can be between 30% and 300%.
-            If it is omitted, text zoom is reset to 100%.
+            Set text zoom value of current web page. Zoom value can
+            be between 30% and 300%.  If it is omitted, text zoom is
+            reset to 100%.
        </p>
    </description>
 </item>
@@ -407,7 +441,7 @@ preference.
 <item>
    <tags>ZI zI</tags>
    <spec><oa>count</oa>ZI</spec>
-    <description>
+    <description short="true">
        <p>Enlarge full zoom of current web page. Mnemonic: zoom in.</p>
    </description>
 </item>
@@ -415,6 +449,7 @@ preference.

 <item>
    <tags>ZM zM</tags>
+    <strut/>
    <spec><oa>count</oa>ZM</spec>
    <description>
        <p>Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
@@ -425,7 +460,7 @@ preference.
 <item>
    <tags>ZO zO</tags>
    <spec><oa>count</oa>ZO</spec>
-    <description>
+    <description short="true">
        <p>Reduce full zoom of current web page. Mnemonic: zoom out.</p>
    </description>
 </item>
@@ -434,7 +469,7 @@ preference.
 <item>
    <tags>ZR zR</tags>
    <spec><oa>count</oa>ZR</spec>
-    <description>
+    <description short="true">
        <p>Reduce full zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
    </description>
 </item>
@@ -442,6 +477,7 @@ preference.

 <item>
    <tags>ZZ zZ</tags>
+    <strut/>
    <spec><oa>count</oa>ZZ</spec>
    <description>
        <p>
@@ -455,7 +491,8 @@ preference.
 <item>
    <tags>:zo :zoom</tags>
    <spec>:zo<oa>om</oa><oa>!</oa> <oa>value</oa></spec>
-    <spec>:zo<oa>om</oa><oa>!</oa> +<a>value</a> | -<a>value</a></spec>
+    <spec>:zo<oa>om</oa><oa>!</oa> +<a>value</a></spec>
+    <spec>:zo<oa>om</oa><oa>!</oa> -<a>value</a></spec>
    <description>
        <p>
            Set zoom value of current web page. <oa>value</oa> can be an absolute value
@@ -476,7 +513,7 @@ preference.
 <item>
    <tags>:frameo :frameonly</tags>
    <spec>:frameo<oa>nly</oa></spec>
-    <description>
+    <description short="true">
        <p>Show only the current frame's page.</p>
    </description>
 </item>
@@ -484,18 +521,17 @@ preference.

 <h2 tag="copying yanking">Copying text</h2>

-When running in X11, the text of the following commands is not only
-copied to the clipboard but is also put into the X11 selection, which
-can be pasted with the middle mouse button:
+<p>
+    When running in X11, the text of the following commands is not only
+    copied to the clipboard but is also put into the X11 selection, which
+    can be pasted with the middle mouse button:
+</p>

 <item>
    <tags>y</tags>
    <spec>y</spec>
-    <description>
-        <p>
-            Yank current location to the clipboard. When running in X11 the location is
-            also put into the selection, which can be pasted with the middle mouse button.
-        </p>
+    <description short="true">
+        <p>Yank current location to the clipboard.</p>
    </description>
 </item>

@@ -503,7 +539,7 @@ can be pasted with the middle mouse button:
 <item>
    <tags>Y</tags>
    <spec>Y</spec>
-    <description>
+    <description short="true">
        <p>Copy currently selected text to the system clipboard.</p>
    </description>
 </item>
@@ -511,16 +547,18 @@ can be pasted with the middle mouse button:

 <h2 tag="alternate-stylesheet">Alternate style sheets</h2>

-Page authors may specify alternate style sheets for an HTML document. Users can
-then switch between these various style sheets, selecting their favorite.
+Page authors may specify alternate style sheets for an HTML
+document. Users can then switch between these various style sheets,
+selecting their favorite.

 <item>
    <tags>:pagest :pagestyle</tags>
    <spec>:pagest<oa>yle</oa> <oa>stylesheet</oa></spec>
    <description>
        <p>
-            Select the author style sheet to apply. If <oa>stylesheet</oa> is not specified
-            the page's default style sheet is used.
+            Select the author style sheet to apply. If
+            <oa>stylesheet</oa> is not specified the page's default
+            style sheet is used.
        </p>

        <p>All author styling can be removed by setting the <o>usermode</o> option.</p>