common/locale/en-US/buffer.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
   3
   4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
   5
   6 <document
   7     name="buffer"
   8     title="&dactyl.appName; Buffer"
   9     xmlns="&xmlns.dactyl;"
  10     xmlns:html="&xmlns.html;">
  11
  12 <h1 tag="buffer document">Buffer</h1>
  13 <toc start="2"/>
  14
  15 <p>
  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.
  20 </p>
  21
  22 <h2 tag="buffer-information">Buffer information</h2>
  23
  24 <item>
  25     <tags><![CDATA[<page-info> <C-g>]]></tags>
  26     <strut/>
  27     <spec>&lt;C-g></spec>
  28     <description>
  29         <p>
  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.
  33         </p>
  34     </description>
  35 </item>
  36
  37 <item>
  38     <tags><![CDATA[<more-page-info> g<C-g>]]></tags>
  39     <spec>g&lt;C-g></spec>
  40     <description short="true">
  41         <p>Print file information. Same as <ex>:pa<oa>geinfo</oa></ex>.</p>
  42     </description>
  43 </item>
  44
  45 <item>
  46     <tags>:pa :pageinfo</tags>
  47     <spec>:pa<oa>geinfo</oa> <oa>items</oa></spec>
  48     <description>
  49         <p>
  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.
  53         </p>
  54     </description>
  55 </item>
  56
  57 <item>
  58     <tags>gf</tags>
  59     <strut/>
  60     <spec>gf</spec>
  61     <description>
  62         <p>
  63             View source. Toggles between the source and rendered
  64             content of the page.
  65         </p>
  66     </description>
  67 </item>
  68
  69 <item>
  70     <tags>gF</tags>
  71     <strut/>
  72     <spec>gF</spec>
  73     <description>
  74         <p>
  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.
  78         </p>
  79     </description>
  80 </item>
  81
  82 <item>
  83     <tags>:vie :viewsource</tags>
  84     <spec>:vie<oa>wsource</oa><oa>!</oa> <oa>url</oa></spec>
  85     <description>
  86         <p>
  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
  90             editor.
  91         </p>
  92     </description>
  93 </item>
  94
  95 <h2 tag="motion scrolling">Motion commands</h2>
  96
  97 <item>
  98     <tags>&lt;scroll-begin> ^ 0</tags>
  99     <strut/>
 100     <spec>0</spec>
 101     <description>
 102         <p>
 103             Scroll to the absolute left of the document. Unlike in
 104             Vim, <k>0</k> and <k>^</k> work exactly the same way.
 105         </p>
 106     </description>
 107 </item>
 108
 109 <item>
 110     <tags>&lt;scroll-end> $</tags>
 111     <spec>$</spec>
 112     <description short="true">
 113         <p>Scroll to the absolute right of the document</p>
 114     </description>
 115 </item>
 116
 117 <item>
 118     <tags><![CDATA[<Home> gg]]></tags>
 119     <strut/>
 120     <spec><oa>count</oa>gg</spec>
 121     <description>
 122         <p>
 123             Go to the top of the document. With <oa>count</oa>,
 124             scroll vertically to <oa>count</oa> percent of the
 125             document.
 126         </p>
 127     </description>
 128 </item>
 129
 130 <item>
 131     <tags><![CDATA[<End> G]]></tags>
 132     <strut/>
 133     <spec><oa>count</oa>G</spec>
 134     <description>
 135         <p>
 136             Go to the end of the document. With <oa>count</oa>,
 137             behaves exactly the same as <oa>gg</oa>.
 138         </p>
 139     </description>
 140 </item>
 141
 142 <item>
 143     <tags>&lt;scroll-percent> N%</tags>
 144     <spec><a>count</a>%</spec>
 145     <description short="true">
 146         <p>Scroll to <a>count</a> percent of the document.</p>
 147     </description>
 148 </item>
 149
 150 <item>
 151     <tags><![CDATA[<scroll-column-left> <Left> h]]></tags>
 152     <strut/>
 153     <spec><oa>count</oa>h</spec>
 154     <description>
 155         <p>
 156             Scroll document to the left. If <oa>count</oa> is specified,
 157             repeat <oa>count</oa> times.
 158         </p>
 159     </description>
 160 </item>
 161
 162 <item>
 163     <tags><![CDATA[<scroll-line-down> <C-e> <Down> j]]></tags>
 164     <strut/>
 165     <spec><oa>count</oa>j</spec>
 166     <description>
 167         <p>
 168             Scroll document to the down. If <oa>count</oa> is specified,
 169             repeat <oa>count</oa> times.
 170         </p>
 171     </description>
 172 </item>
 173
 174 <item>
 175     <tags><![CDATA[<scroll-line-up> <C-y> <Up> k]]></tags>
 176     <strut/>
 177     <spec><oa>count</oa>k</spec>
 178     <description>
 179         <p>
 180             Scroll document to the up. If <oa>count</oa> is specified,
 181             repeat <oa>count</oa> times.
 182         </p>
 183     </description>
 184 </item>
 185
 186 <item>
 187     <tags><![CDATA[<scroll-column-right> <Right> l]]></tags>
 188     <strut/>
 189     <spec><oa>count</oa>l</spec>
 190     <description>
 191         <p>
 192             Scroll document to the right. If <oa>count</oa> is specified,
 193             repeat <oa>count</oa> times.
 194         </p>
 195     </description>
 196 </item>
 197
 198 <item>
 199     <tags><![CDATA[<scroll-down> <C-d>]]></tags>
 200     <strut/>
 201     <spec><oa>count</oa>&lt;C-d></spec>
 202     <description>
 203         <p>
 204             Scroll window downwards by the amount specified in the
 205             <o>scroll</o> option. With <oa>count</oa>, scroll as if
 206             <o>scroll</o> were set to <oa>count</oa>.
 207         </p>
 208     </description>
 209 </item>
 210
 211 <item>
 212     <tags><![CDATA[<scroll-up> <C-u>]]></tags>
 213     <strut/>
 214     <spec><oa>count</oa>&lt;C-u></spec>
 215     <description>
 216         <p>
 217             Scroll window upwards by the amount specified in the
 218             <o>scroll</o> option. With <oa>count</oa>, scroll as if
 219             <o>scroll</o> were set to <oa>count</oa>.
 220         </p>
 221     </description>
 222 </item>
 223
 224 <item>
 225     <tags><![CDATA[<scroll-page-up> <S-Space> <PageUp> <C-b>]]></tags>
 226     <strut/>
 227     <spec><oa>count</oa>&lt;C-b></spec>
 228     <description>
 229         <p>
 230             Scroll up a full page. With <oa>count</oa>, scroll up
 231             <oa>count</oa> full pages.
 232         </p>
 233     </description>
 234 </item>
 235
 236 <item>
 237     <tags><![CDATA[<scroll-page-down> <Space> <PageDown> <C-f>]]></tags>
 238     <strut/>
 239     <spec><oa>count</oa>&lt;C-f></spec>
 240     <description>
 241         <p>
 242             Scroll down a full page. With <oa>count</oa>, scroll
 243             down <oa>count</oa> full pages.
 244         </p>
 245     </description>
 246 </item>
 247
 248 <h2 tag="jumping">Jumping to elements</h2>
 249
 250 <item>
 251     <tags><![CDATA[<Tab>]]></tags>
 252     <spec>&lt;Tab></spec>
 253     <description short="true">
 254         <p>Advance keyboard focus to the next element.</p>
 255     </description>
 256 </item>
 257
 258 <item>
 259     <tags><![CDATA[<S-Tab>]]></tags>
 260     <spec>&lt;S-Tab></spec>
 261     <description short="true">
 262         <p>Rewind keyboard focus to the previous element.</p>
 263     </description>
 264 </item>
 265
 266 <item>
 267     <tags>&lt;focus-input> gi</tags>
 268     <strut/>
 269     <spec><oa>count</oa>gi</spec>
 270     <description>
 271         <p>
 272             Focus last used input field. If there is no last input
 273             field, focus the first input field. With <oa>count</oa>,
 274             focus the <oa>count</oa>th input field.
 275         </p>
 276     </description>
 277 </item>
 278
 279 <item>
 280     <tags>&lt;next-frame> ]f</tags>
 281     <strut/>
 282     <spec><oa>count</oa>]f</spec>
 283     <description>
 284         <p>
 285             Transfer keyboard focus to the <oa>count</oa>th next
 286             frame. The newly focused frame is briefly highlighted
 287             with <h>FrameIndicator</h>.
 288         </p>
 289     </description>
 290 </item>
 291
 292 <item>
 293     <tags>&lt;previous-frame> [f</tags>
 294     <strut/>
 295     <spec><oa>count</oa>[f</spec>
 296     <description>
 297         <p>
 298             Transfer keyboard focus to the <oa>count</oa>th next
 299             previous frame. The newly focused frame is briefly highlighted
 300             with <h>FrameIndicator</h>.
 301         </p>
 302     </description>
 303 </item>
 304
 305 <item>
 306     <tags>&lt;next-page> ]]</tags>
 307     <strut/>
 308     <spec><oa>count</oa>]]</spec>
 309     <description>
 310         <p>
 311             Follow the last link matching <o>nextpattern</o>. Used,
 312             for instance, to move to the next page of search
 313             results.
 314         </p>
 315     </description>
 316 </item>
 317
 318 <item>
 319     <tags>&lt;previous-page> [[</tags>
 320     <strut/>
 321     <spec><oa>count</oa>[[</spec>
 322     <description>
 323         <p>
 324             Follow the last link matching <o>previouspattern</o>. Used,
 325             for instance, to move to the previous page of search
 326             results.
 327         </p>
 328     </description>
 329 </item>
 330
 331 <h2 tag="zooming zoom">Zooming</h2>
 332
 333 <p>
 334     The zooming commands are dependent on two properties—a zoom
 335     range and a series of levels within that range.
 336 </p>
 337
 338 <p>
 339     The absolute value of the page zoom is limited to a value within
 340     the configured zoom range (default: 30%–300%). By default,
 341     commands which zoom in or out select between the zoom levels,
 342     30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%, 170%,
 343     200%, 240%, 300%.
 344 </p>
 345
 346 <p>
 347     The available zoom range can be changed by setting the
 348     <pref>zoom.minPercent</pref>
 349     and
 350     <pref>zoom.maxPercent</pref>
 351     &dactyl.host; preferences. The zoom levels can be changed using the
 352     <pref>toolkit.zoomManager.zoomValues</pref>
 353     preference.
 354 </p>
 355
 356 <note>
 357     <pref>toolkit.zoomManager.zoomValues</pref> is specified as a
 358     list of values between <em>0</em> and <em>1</em> rather than
 359     percentages. For instance, <em>0.5</em> is equivalent to
 360     <em>50%</em>.
 361 </note>
 362
 363 <item>
 364     <tags><![CDATA[<text-zoom-in> + zi]]></tags>
 365     <spec><oa>count</oa>zi</spec>
 366     <description short="true">
 367         <p>Enlarge text zoom of current web page. Mnemonic: zoom in.</p>
 368     </description>
 369 </item>
 370
 371 <item>
 372     <tags><![CDATA[<text-zoom-more> zm]]></tags>
 373     <strut/>
 374     <spec><oa>count</oa>zm</spec>
 375     <description>
 376         <p>Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 377     </description>
 378 </item>
 379
 380 <item>
 381     <tags><![CDATA[<text-zoom-out> - zo]]></tags>
 382     <spec><oa>count</oa>zo</spec>
 383     <description short="true">
 384         <p>Reduce text zoom of current web page. Mnemonic: zoom out.</p>
 385     </description>
 386 </item>
 387
 388 <item>
 389     <tags><![CDATA[<text-zoom-reduce> zr]]></tags>
 390     <spec><oa>count</oa>zr</spec>
 391     <description short="true">
 392         <p>Reduce text zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
 393     </description>
 394 </item>
 395
 396 <item>
 397     <tags><![CDATA[<text-zoom> zz]]></tags>
 398     <strut/>
 399     <spec><oa>count</oa>zz</spec>
 400     <description>
 401         <p>
 402             Set text zoom value of current web page. Zoom value can
 403             be between 30% and 300%.  If it is omitted, text zoom is
 404             reset to 100%.
 405         </p>
 406     </description>
 407 </item>
 408
 409 <item>
 410     <tags><![CDATA[<full-zoom-in> ZI zI]]></tags>
 411     <spec><oa>count</oa>ZI</spec>
 412     <description short="true">
 413         <p>Enlarge full zoom of current web page. Mnemonic: zoom in.</p>
 414     </description>
 415 </item>
 416
 417 <item>
 418     <tags><![CDATA[<full-zoom-more> ZM zM]]></tags>
 419     <strut/>
 420     <spec><oa>count</oa>ZM</spec>
 421     <description>
 422         <p>Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 423     </description>
 424 </item>
 425
 426 <item>
 427     <tags><![CDATA[<full-zoom-out> ZO zO]]></tags>
 428     <spec><oa>count</oa>ZO</spec>
 429     <description short="true">
 430         <p>Reduce full zoom of current web page. Mnemonic: zoom out.</p>
 431     </description>
 432 </item>
 433
 434 <item>
 435     <tags><![CDATA[<full-zoom-reduce> ZR zR]]></tags>
 436     <spec><oa>count</oa>ZR</spec>
 437     <description short="true">
 438         <p>Reduce full zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
 439     </description>
 440 </item>
 441
 442 <item>
 443     <tags><![CDATA[<full-zoom> zZ]]></tags>
 444     <strut/>
 445     <spec><oa>count</oa>zZ</spec>
 446     <description>
 447         <p>
 448             Set full zoom value of current web page. Zoom value can be between 30 and
 449             300%. If it is omitted, full zoom is reset to 100%.
 450         </p>
 451     </description>
 452 </item>
 453
 454 <item>
 455     <tags>:zo :zoom</tags>
 456     <spec>:zo<oa>om</oa><oa>!</oa> <oa>value</oa></spec>
 457     <spec>:zo<oa>om</oa><oa>!</oa> +<a>value</a></spec>
 458     <spec>:zo<oa>om</oa><oa>!</oa> -<a>value</a></spec>
 459     <description>
 460         <p>
 461             Set zoom value of current web page. <oa>value</oa> can be an absolute value
 462             between 30% and 300% or a relative value if prefixed with "-" or "+". If
 463             <oa>value</oa> is omitted, zoom is reset to 100%.
 464         </p>
 465
 466         <p>
 467             Normally this command operates on the text zoom; if used with <oa>!</oa>, it
 468             operates on full zoom.
 469         </p>
 470     </description>
 471 </item>
 472
 473 <h2 tag="frames">Working with frames</h2>
 474
 475 <item>
 476     <tags>:frameo :frameonly</tags>
 477     <spec>:frameo<oa>nly</oa></spec>
 478     <description short="true">
 479         <p>Show only the current frame's page.</p>
 480     </description>
 481 </item>
 482
 483 <h2 tag="copying yanking">Copying text</h2>
 484
 485 <p>
 486     When running in X11, the text of the following commands is not only
 487     copied to the clipboard but is also put into the X11 selection, which
 488     can be pasted with the middle mouse button:
 489 </p>
 490
 491 <item>
 492     <tags>&lt;yank-location> y</tags>
 493     <spec>y</spec>
 494     <description short="true">
 495         <p>Yank current location to the clipboard.</p>
 496     </description>
 497 </item>
 498
 499 <item>
 500     <tags>&lt;yank-word> Y</tags>
 501     <spec>Y</spec>
 502     <description short="true">
 503         <p>Copy currently selected text to the system clipboard.</p>
 504     </description>
 505 </item>
 506
 507 <h2 tag="alternate-stylesheet">Alternate style sheets</h2>
 508
 509 Page authors may specify alternate style sheets for an HTML
 510 document. Users can then switch between these various style sheets,
 511 selecting their favorite.
 512
 513 <item>
 514     <tags>:pagest :pagestyle</tags>
 515     <spec>:pagest<oa>yle</oa> <oa>stylesheet</oa></spec>
 516     <description>
 517         <p>
 518             Select the author style sheet to apply. If
 519             <oa>stylesheet</oa> is not specified the page's default
 520             style sheet is used.
 521         </p>
 522
 523         <p>All author styling can be removed by setting the <o>usermode</o> option.</p>
 524     </description>
 525 </item>
 526
 527 </document>
 528
 529 <!-- vim:se sts=4 sw=4 et: -->