1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
8 title="&dactyl.appName; Buffer"
10 xmlns:html="&xmlns.html;">
12 <h1 tag="buffer document">Buffer</h1>
16 A buffer is a container that holds the given web page, including
17 all of its history and frames. Each tab contains exactly one
18 buffer, and for most purposes the two terms are interchangeable.
19 See <t>tabs</t> for more.
22 <h2 tag="buffer-information">Buffer information</h2>
25 <tags><![CDATA[<page-info> <C-g>]]></tags>
30 Print the current file name along with basic page
31 information including last modification time, the number
32 of feeds present, and the page title.
38 <tags><![CDATA[<more-page-info> g<C-g>]]></tags>
39 <spec>g<C-g></spec>
40 <description short="true">
41 <p>Print file information. Same as <ex>:pa<oa>geinfo</oa></ex>.</p>
46 <tags>:pa :pageinfo</tags>
47 <spec>:pa<oa>geinfo</oa> <oa>items</oa></spec>
50 Show various page information. The information provided
51 is determined by the value of <o>pageinfo</o>, or
52 <oa>items</oa> if present.
58 <tags><![CDATA[<view-source> gf]]></tags>
63 View source. Toggles between the source and rendered
70 <tags><![CDATA[<view-source-externally> gF]]></tags>
75 View source with an external editor. Opens the source
76 code of the current web site with the external editor
77 specified by the <o>editor</o> option.
83 <tags>:vie :viewsource</tags>
84 <spec>:vie<oa>wsource</oa><oa>!</oa> <oa>url</oa></spec>
87 View source code of current document. If <oa>url</oa> is
88 specified then view the source of that document. When
89 <oa>!</oa> is given, it is opened with the external
95 <h2 tag="motion scrolling">Motion commands</h2>
98 <tags><scroll-begin> ^ 0</tags>
103 Scroll to the absolute left of the document. Unlike in
104 Vim, <k>0</k> and <k>^</k> work exactly the same way.
110 <tags><scroll-end> $</tags>
112 <description short="true">
113 <p>Scroll to the absolute right of the document</p>
118 <tags><![CDATA[<scroll-top> <Home> gg]]></tags>
120 <spec><oa>count</oa>gg</spec>
123 Go to the top of the document. With <oa>count</oa>,
124 scroll vertically to <oa>count</oa> percent of the
131 <tags><![CDATA[<scroll-bottom> <End> G]]></tags>
133 <spec><oa>count</oa>G</spec>
136 Go to the end of the document. With <oa>count</oa>,
137 go to the <oa>count</oa>th line as determined by <o>linenumbers</o>,
138 or by the line height of the document body otherwise.
144 <tags><scroll-percent> N% %</tags>
145 <spec><a>count</a>%</spec>
146 <description short="true">
147 <p>Scroll to <a>count</a> percent of the document.</p>
152 <tags><![CDATA[<scroll-left-column> <Left> h]]></tags>
154 <spec><oa>count</oa>h</spec>
157 Scroll document to the left. If <oa>count</oa> is specified,
158 repeat <oa>count</oa> times.
164 <tags><![CDATA[<scroll-down-line> <C-e> <Down> j]]></tags>
166 <spec><oa>count</oa>j</spec>
169 Scroll document to the down. If <oa>count</oa> is specified,
170 repeat <oa>count</oa> times.
176 <tags><![CDATA[<scroll-up-line> <C-y> <Up> k]]></tags>
178 <spec><oa>count</oa>k</spec>
181 Scroll document to the up. If <oa>count</oa> is specified,
182 repeat <oa>count</oa> times.
188 <tags><![CDATA[<scroll-right-column> <Right> l]]></tags>
190 <spec><oa>count</oa>l</spec>
193 Scroll document to the right. If <oa>count</oa> is specified,
194 repeat <oa>count</oa> times.
200 <tags><![CDATA[<scroll-down> <C-d>]]></tags>
202 <spec><oa>count</oa><C-d></spec>
205 Scroll window downwards by the amount specified in the
206 <o>scroll</o> option. With <oa>count</oa>, set the <o>scroll</o>
207 option to <oa>count</oa> before executing the command.
213 <tags><![CDATA[<scroll-up> <C-u>]]></tags>
215 <spec><oa>count</oa><C-u></spec>
218 Scroll window upwards by the amount specified in the <o>scroll</o>
219 option. With <oa>count</oa>, set the <o>scroll</o> option to
220 <oa>count</oa> before executing the command.
226 <tags><![CDATA[<scroll-up-page> <S-Space> <PageUp> <C-b>]]></tags>
228 <spec><oa>count</oa><C-b></spec>
231 Scroll up a full page. With <oa>count</oa>, scroll up
232 <oa>count</oa> full pages.
238 <tags><![CDATA[<scroll-down-page> <Space> <PageDown> <C-f>]]></tags>
240 <spec><oa>count</oa><C-f></spec>
243 Scroll down a full page. With <oa>count</oa>, scroll
244 down <oa>count</oa> full pages.
249 <h2 tag="jumping">Jumping to elements</h2>
252 <tags><![CDATA[<Tab>]]></tags>
253 <spec><Tab></spec>
254 <description short="true">
255 <p>Advance keyboard focus to the next element.</p>
260 <tags><![CDATA[<S-Tab>]]></tags>
261 <spec><S-Tab></spec>
262 <description short="true">
263 <p>Rewind keyboard focus to the previous element.</p>
268 <tags><focus-input> gi</tags>
270 <spec><oa>count</oa>gi</spec>
273 Focus last used input field. If there is no last input
274 field, focus the first input field. With <oa>count</oa>,
275 focus the <oa>count</oa>th input field.
281 <tags><next-frame> ]f</tags>
283 <spec><oa>count</oa>]f</spec>
286 Transfer keyboard focus to the <oa>count</oa>th next
287 frame. The newly focused frame is briefly highlighted
288 with <h>FrameIndicator</h>.
294 <tags><previous-frame> [f</tags>
296 <spec><oa>count</oa>[f</spec>
299 Transfer keyboard focus to the <oa>count</oa>th next
300 previous frame. The newly focused frame is briefly highlighted
301 with <h>FrameIndicator</h>.
307 <tags><next-page> ]]</tags>
309 <spec><oa>count</oa>]]</spec>
312 Follow the last link matching <o>nextpattern</o>. Used,
313 for instance, to move to the next page of search
320 <tags><previous-page> [[</tags>
322 <spec><oa>count</oa>[[</spec>
325 Follow the last link matching <o>previouspattern</o>. Used,
326 for instance, to move to the previous page of search
334 <spec><oa>count</oa>[<a>arg</a></spec>
335 <description short="true">
336 <p>Jump to the previous element as defined by <o>jumptags</o>.</p>
342 <spec><oa>count</oa>]<a>arg</a></spec>
343 <description short="true">
344 <p>Jump to the next element as defined by <o>jumptags</o>.</p>
350 <spec><oa>count</oa>g]<a>arg</a></spec>
351 <description short="true">
352 <p>Jump to the next off-screen element as defined by <o>jumptags</o>.</p>
359 <spec><oa>count</oa>{</spec>
360 <description short="true">
361 <p>Jump to the previous paragraph. Identical to <k>[p</k>.</p>
367 <spec><oa>count</oa>}</spec>
368 <description short="true">
369 <p>Jump to the next paragraph. Identical to <k>]p</k>.</p>
374 <h2 tag="zooming zoom">Zooming</h2>
377 The zooming commands are dependent on two properties—a zoom
378 range and a series of levels within that range.
382 The absolute value of the page zoom is limited to a value within
383 the configured zoom range (default: 30%–300%). By default,
384 commands which zoom in or out select between the zoom levels,
385 30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%, 170%,
390 The available zoom range can be changed by setting the
391 <pref>zoom.minPercent</pref>
393 <pref>zoom.maxPercent</pref>
394 &dactyl.host; preferences. The zoom levels can be changed using the
395 <pref>toolkit.zoomManager.zoomValues</pref>
400 <pref>toolkit.zoomManager.zoomValues</pref> is specified as a
401 list of values between <em>0</em> and <em>1</em> rather than
402 percentages. For instance, <em>0.5</em> is equivalent to
407 <tags><![CDATA[<text-zoom-in> + zi]]></tags>
408 <spec><oa>count</oa>zi</spec>
409 <description short="true">
410 <p>Enlarge text zoom of current web page. Mnemonic: zoom in.</p>
415 <tags><![CDATA[<text-zoom-more> zm]]></tags>
417 <spec><oa>count</oa>zm</spec>
419 <p>Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
424 <tags><![CDATA[<text-zoom-out> - zo]]></tags>
425 <spec><oa>count</oa>zo</spec>
426 <description short="true">
427 <p>Reduce text zoom of current web page. Mnemonic: zoom out.</p>
432 <tags><![CDATA[<text-zoom-reduce> zr]]></tags>
433 <spec><oa>count</oa>zr</spec>
434 <description short="true">
435 <p>Reduce text zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
440 <tags><![CDATA[<text-zoom> zz]]></tags>
442 <spec><oa>count</oa>zz</spec>
445 Set text zoom value of current web page. Zoom value can
446 be between 30% and 300%. If it is omitted, text zoom is
453 <tags><![CDATA[<full-zoom-in> ZI zI]]></tags>
454 <spec><oa>count</oa>ZI</spec>
455 <description short="true">
456 <p>Enlarge full zoom of current web page. Mnemonic: zoom in.</p>
461 <tags><![CDATA[<full-zoom-more> ZM zM]]></tags>
463 <spec><oa>count</oa>ZM</spec>
465 <p>Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
470 <tags><![CDATA[<full-zoom-out> ZO zO]]></tags>
471 <spec><oa>count</oa>ZO</spec>
472 <description short="true">
473 <p>Reduce full zoom of current web page. Mnemonic: zoom out.</p>
478 <tags><![CDATA[<full-zoom-reduce> ZR zR]]></tags>
479 <spec><oa>count</oa>ZR</spec>
480 <description short="true">
481 <p>Reduce full zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
486 <tags><![CDATA[<full-zoom> zZ]]></tags>
488 <spec><oa>count</oa>zZ</spec>
491 Set full zoom value of current web page. Zoom value can be between 30 and
492 300%. If it is omitted, full zoom is reset to 100%.
498 <tags>:zo :zoom</tags>
499 <spec>:zo<oa>om</oa><oa>!</oa> <oa>value</oa></spec>
500 <spec>:zo<oa>om</oa><oa>!</oa> +<a>value</a></spec>
501 <spec>:zo<oa>om</oa><oa>!</oa> -<a>value</a></spec>
504 Set zoom value of current web page. <oa>value</oa> can be an absolute value
505 between 30% and 300% or a relative value if prefixed with "-" or "+". If
506 <oa>value</oa> is omitted, zoom is reset to 100%.
510 Normally this command operates on the text zoom; if used with <oa>!</oa>, it
511 operates on full zoom.
516 <h2 tag="frames">Working with frames</h2>
519 <tags>:frameo :frameonly</tags>
520 <spec>:frameo<oa>nly</oa></spec>
521 <description short="true">
522 <p>Show only the current frame's page.</p>
526 <h2 tag="copying yanking">Copying text</h2>
529 When running in X11, the text of the following commands is not only
530 copied to the clipboard but is also put into the X11 selection, which
531 can be pasted with the middle mouse button:
535 <tags><yank-location> y</tags>
537 <description short="true">
538 <p>Yank current location to the clipboard.</p>
543 <tags><yank-selection> Y</tags>
545 <description short="true">
546 <p>Copy currently selected text to the system clipboard.</p>
550 <h2 tag="alternate-stylesheet">Alternate style sheets</h2>
552 Page authors may specify alternate style sheets for an HTML
553 document. Users can then switch between these various style sheets,
554 selecting their favorite.
557 <tags>:pagest :pagestyle</tags>
558 <spec>:pagest<oa>yle</oa> <oa>stylesheet</oa></spec>
561 Select the author style sheet to apply. If
562 <oa>stylesheet</oa> is not specified the page's default
566 <p>All author styling can be removed by setting the <o>usermode</o> option.</p>
572 <!-- vim:se sts=4 sw=4 et: -->