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><![CDATA[<view-source> 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><![CDATA[<view-source-externally> 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[<scroll-top> <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[<scroll-bottom> <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             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.
 139         </p>
 140     </description>
 141 </item>
 142
 143 <item>
 144     <tags>&lt;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>
 148     </description>
 149 </item>
 150
 151 <item>
 152     <tags><![CDATA[<scroll-left-column> <Left> h]]></tags>
 153     <strut/>
 154     <spec><oa>count</oa>h</spec>
 155     <description>
 156         <p>
 157             Scroll document to the left. If <oa>count</oa> is specified,
 158             repeat <oa>count</oa> times.
 159         </p>
 160     </description>
 161 </item>
 162
 163 <item>
 164     <tags><![CDATA[<scroll-down-line> <C-e> <Down> j]]></tags>
 165     <strut/>
 166     <spec><oa>count</oa>j</spec>
 167     <description>
 168         <p>
 169             Scroll document to the down. If <oa>count</oa> is specified,
 170             repeat <oa>count</oa> times.
 171         </p>
 172     </description>
 173 </item>
 174
 175 <item>
 176     <tags><![CDATA[<scroll-up-line> <C-y> <Up> k]]></tags>
 177     <strut/>
 178     <spec><oa>count</oa>k</spec>
 179     <description>
 180         <p>
 181             Scroll document to the up. If <oa>count</oa> is specified,
 182             repeat <oa>count</oa> times.
 183         </p>
 184     </description>
 185 </item>
 186
 187 <item>
 188     <tags><![CDATA[<scroll-right-column> <Right> l]]></tags>
 189     <strut/>
 190     <spec><oa>count</oa>l</spec>
 191     <description>
 192         <p>
 193             Scroll document to the right. If <oa>count</oa> is specified,
 194             repeat <oa>count</oa> times.
 195         </p>
 196     </description>
 197 </item>
 198
 199 <item>
 200     <tags><![CDATA[<scroll-down> <C-d>]]></tags>
 201     <strut/>
 202     <spec><oa>count</oa>&lt;C-d></spec>
 203     <description>
 204         <p>
 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.
 208         </p>
 209     </description>
 210 </item>
 211
 212 <item>
 213     <tags><![CDATA[<scroll-up> <C-u>]]></tags>
 214     <strut/>
 215     <spec><oa>count</oa>&lt;C-u></spec>
 216     <description>
 217         <p>
 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.
 221         </p>
 222     </description>
 223 </item>
 224
 225 <item>
 226     <tags><![CDATA[<scroll-up-page> <S-Space> <PageUp> <C-b>]]></tags>
 227     <strut/>
 228     <spec><oa>count</oa>&lt;C-b></spec>
 229     <description>
 230         <p>
 231             Scroll up a full page. With <oa>count</oa>, scroll up
 232             <oa>count</oa> full pages.
 233         </p>
 234     </description>
 235 </item>
 236
 237 <item>
 238     <tags><![CDATA[<scroll-down-page> <Space> <PageDown> <C-f>]]></tags>
 239     <strut/>
 240     <spec><oa>count</oa>&lt;C-f></spec>
 241     <description>
 242         <p>
 243             Scroll down a full page. With <oa>count</oa>, scroll
 244             down <oa>count</oa> full pages.
 245         </p>
 246     </description>
 247 </item>
 248
 249 <h2 tag="jumping">Jumping to elements</h2>
 250
 251 <item>
 252     <tags><![CDATA[<Tab>]]></tags>
 253     <spec>&lt;Tab></spec>
 254     <description short="true">
 255         <p>Advance keyboard focus to the next element.</p>
 256     </description>
 257 </item>
 258
 259 <item>
 260     <tags><![CDATA[<S-Tab>]]></tags>
 261     <spec>&lt;S-Tab></spec>
 262     <description short="true">
 263         <p>Rewind keyboard focus to the previous element.</p>
 264     </description>
 265 </item>
 266
 267 <item>
 268     <tags>&lt;focus-input> gi</tags>
 269     <strut/>
 270     <spec><oa>count</oa>gi</spec>
 271     <description>
 272         <p>
 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.
 276         </p>
 277     </description>
 278 </item>
 279
 280 <item>
 281     <tags>&lt;next-frame> ]f</tags>
 282     <strut/>
 283     <spec><oa>count</oa>]f</spec>
 284     <description>
 285         <p>
 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>.
 289         </p>
 290     </description>
 291 </item>
 292
 293 <item>
 294     <tags>&lt;previous-frame> [f</tags>
 295     <strut/>
 296     <spec><oa>count</oa>[f</spec>
 297     <description>
 298         <p>
 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>.
 302         </p>
 303     </description>
 304 </item>
 305
 306 <item>
 307     <tags>&lt;next-page> ]]</tags>
 308     <strut/>
 309     <spec><oa>count</oa>]]</spec>
 310     <description>
 311         <p>
 312             Follow the last link matching <o>nextpattern</o>. Used,
 313             for instance, to move to the next page of search
 314             results.
 315         </p>
 316     </description>
 317 </item>
 318
 319 <item>
 320     <tags>&lt;previous-page> [[</tags>
 321     <strut/>
 322     <spec><oa>count</oa>[[</spec>
 323     <description>
 324         <p>
 325             Follow the last link matching <o>previouspattern</o>. Used,
 326             for instance, to move to the previous page of search
 327             results.
 328         </p>
 329     </description>
 330 </item>
 331
 332 <item>
 333     <tags>[h [p [</tags>
 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>
 337     </description>
 338 </item>
 339
 340 <item>
 341     <tags>]h ]p ]</tags>
 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>
 345     </description>
 346 </item>
 347
 348 <item>
 349     <tags>g]</tags>
 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>
 353     </description>
 354 </item>
 355
 356
 357 <item>
 358     <tags>{</tags>
 359     <spec><oa>count</oa>{</spec>
 360     <description short="true">
 361         <p>Jump to the previous paragraph. Identical to <k>[p</k>.</p>
 362     </description>
 363 </item>
 364
 365 <item>
 366     <tags>}</tags>
 367     <spec><oa>count</oa>}</spec>
 368     <description short="true">
 369         <p>Jump to the next paragraph. Identical to <k>]p</k>.</p>
 370     </description>
 371 </item>
 372
 373
 374 <h2 tag="zooming zoom">Zooming</h2>
 375
 376 <p>
 377     The zooming commands are dependent on two properties—a zoom
 378     range and a series of levels within that range.
 379 </p>
 380
 381 <p>
 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%,
 386     200%, 240%, 300%.
 387 </p>
 388
 389 <p>
 390     The available zoom range can be changed by setting the
 391     <pref>zoom.minPercent</pref>
 392     and
 393     <pref>zoom.maxPercent</pref>
 394     &dactyl.host; preferences. The zoom levels can be changed using the
 395     <pref>toolkit.zoomManager.zoomValues</pref>
 396     preference.
 397 </p>
 398
 399 <note>
 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
 403     <em>50%</em>.
 404 </note>
 405
 406 <item>
 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>
 411     </description>
 412 </item>
 413
 414 <item>
 415     <tags><![CDATA[<text-zoom-more> zm]]></tags>
 416     <strut/>
 417     <spec><oa>count</oa>zm</spec>
 418     <description>
 419         <p>Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 420     </description>
 421 </item>
 422
 423 <item>
 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>
 428     </description>
 429 </item>
 430
 431 <item>
 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>
 436     </description>
 437 </item>
 438
 439 <item>
 440     <tags><![CDATA[<text-zoom> zz]]></tags>
 441     <strut/>
 442     <spec><oa>count</oa>zz</spec>
 443     <description>
 444         <p>
 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
 447             reset to 100%.
 448         </p>
 449     </description>
 450 </item>
 451
 452 <item>
 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>
 457     </description>
 458 </item>
 459
 460 <item>
 461     <tags><![CDATA[<full-zoom-more> ZM zM]]></tags>
 462     <strut/>
 463     <spec><oa>count</oa>ZM</spec>
 464     <description>
 465         <p>Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 466     </description>
 467 </item>
 468
 469 <item>
 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>
 474     </description>
 475 </item>
 476
 477 <item>
 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>
 482     </description>
 483 </item>
 484
 485 <item>
 486     <tags><![CDATA[<full-zoom> zZ]]></tags>
 487     <strut/>
 488     <spec><oa>count</oa>zZ</spec>
 489     <description>
 490         <p>
 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%.
 493         </p>
 494     </description>
 495 </item>
 496
 497 <item>
 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>
 502     <description>
 503         <p>
 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%.
 507         </p>
 508
 509         <p>
 510             Normally this command operates on the text zoom; if used with <oa>!</oa>, it
 511             operates on full zoom.
 512         </p>
 513     </description>
 514 </item>
 515
 516 <h2 tag="frames">Working with frames</h2>
 517
 518 <item>
 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>
 523     </description>
 524 </item>
 525
 526 <h2 tag="copying yanking">Copying text</h2>
 527
 528 <p>
 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:
 532 </p>
 533
 534 <item>
 535     <tags>&lt;yank-location> y</tags>
 536     <strut/>
 537     <spec>y</spec>
 538     <description>
 539         <p>Yank current location to the clipboard. See also
 540             <o>yankshort</o>.</p>
 541     </description>
 542 </item>
 543
 544 <item>
 545     <tags>&lt;yank-selection> Y</tags>
 546     <spec>Y</spec>
 547     <description short="true">
 548         <p>Copy currently selected text to the system clipboard.</p>
 549     </description>
 550 </item>
 551
 552 <h2 tag="alternate-stylesheet">Alternate style sheets</h2>
 553
 554 Page authors may specify alternate style sheets for an HTML
 555 document. Users can then switch between these various style sheets,
 556 selecting their favorite.
 557
 558 <item>
 559     <tags>:pagest :pagestyle</tags>
 560     <spec>:pagest<oa>yle</oa> <oa>stylesheet</oa></spec>
 561     <description>
 562         <p>
 563             Select the author style sheet to apply. If
 564             <oa>stylesheet</oa> is not specified the page's default
 565             style sheet is used.
 566         </p>
 567
 568         <p>All author styling can be removed by setting the <o>usermode</o> option.</p>
 569     </description>
 570 </item>
 571
 572 </document>
 573
 574 <!-- vim:se sts=4 sw=4 et: -->