common/locale/en-US/tabs.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="tabs"
   8     title="&dactyl.appName; Tabs"
   9     xmlns="&xmlns.dactyl;"
  10     xmlns:html="&xmlns.html;">
  11
  12 <h1 tag="tabs buffers">Tabs and buffers</h1>
  13 <toc start="2"/>
  14
  15 <p>
  16     Tabs allow you to keep many web pages open at the same time and to quickly
  17     switch between them. Each tab contains exactly one buffer. If your version
  18     of &dactyl.host; supports tab groups, only buffers in the active group
  19     will be attached to visible tabs. Although not all buffers are always
  20     attached to visible tabs, they are all always accessible via the
  21     buffer-centric commands and key bindings. Tab-centric commands and key
  22     bindings, however, only operate on the set of visible tabs.
  23 </p>
  24
  25 <p>
  26
  27 </p>
  28
  29 <h2 tag="listing-tabs">Listing tabs</h2>
  30
  31 <item>
  32     <tags>B :tabs :ls :files :buffers</tags>
  33     <spec>:buffers <oa>filter</oa></spec>
  34     <spec>B</spec>
  35     <description>
  36         <p>
  37             Show a list of buffers matching <oa>filter</oa>. Buffers are
  38             listed according to their tab groups, whether they are visible or
  39             not.
  40         </p>
  41
  42         <p>A buffer may be marked with one of the following indicators:</p>
  43
  44         <dl dt="width: 6em;">
  45             <dt><hl key="Indicator">%</hl></dt><dd>The current buffer</dd>
  46             <dt><hl key="Indicator">#</hl></dt><dd>The alternate buffer for <ex>:buffer #</ex> and <k name="C-^"/></dd>
  47         </dl>
  48     </description>
  49 </item>
  50
  51 <item>
  52     <tags>:keepa :keepalt</tags>
  53     <spec>:keepa<oa>lt</oa> <a>cmd</a></spec>
  54     <description>
  55         <p>Execute a command without changing the current alternate buffer.</p>
  56     </description>
  57 </item>
  58
  59 <h2 tag="opening-tabs">Opening tabs</h2>
  60
  61 <item>
  62     <tags>:tab</tags>
  63     <strut/>
  64     <spec>:tab <a>cmd</a></spec>
  65     <description>
  66         <p>
  67             Execute <a>cmd</a>, but open any new pages in a new tab rather
  68             than the currently focused tab.
  69         </p>
  70     </description>
  71 </item>
  72
  73 <item>
  74     <!-- TODO: move this somewhere more appropriate -->
  75     <tags>:window :wind</tags>
  76     <spec>:wind<oa>ow</oa> <a>cmd</a></spec>
  77     <description>
  78         <p>
  79             Execute <a>cmd</a>, but open any new pages in a new window rather
  80             than the currently focused tab.
  81         </p>
  82     </description>
  83 </item>
  84
  85 <!-- TODO: should the tab commands be moved back here? -->
  86 <p>
  87     See <t>opening</t> for other ways to open new tabs.
  88 </p>
  89
  90 <h2 tag="changing-tabs">Changing tabs</h2>
  91
  92 <item>
  93     <tags>gb</tags>
  94     <strut/>
  95     <spec><oa>count</oa>gb</spec>
  96     <description>
  97         <p>
  98             Repeat last <ex>:buffer<oa>!</oa></ex> command. This is useful to quickly jump between
  99             buffers which have a similar URL or title.
 100         </p>
 101     </description>
 102 </item>
 103
 104 <item>
 105     <tags>gB</tags>
 106     <strut/>
 107     <spec><oa>count</oa>gB</spec>
 108     <description>
 109         <p>
 110             Repeat last <ex>:buffer<oa>!</oa></ex> command in the reverse direction.
 111         </p>
 112     </description>
 113 </item>
 114
 115 <item>
 116     <tags>gt</tags>
 117     <strut/>
 118     <spec><oa>count</oa>gt</spec>
 119     <description>
 120         <p>
 121             Go to the next tab. Cycles to the first tab when the last one is selected.
 122             If <oa>count</oa> is specified, go to the <oa>count</oa>th tab.
 123         </p>
 124     </description>
 125 </item>
 126
 127 <item>
 128     <tags><![CDATA[<C-PageDown> <C-Tab> <C-n>]]></tags>
 129     <strut/>
 130     <spec><oa>count</oa>&lt;C-n></spec>
 131     <description>
 132         <p>
 133             Go to the next tab. Cycles to the first tab when the last one is selected.
 134             If <oa>count</oa> is specified, go to the <oa>count</oa>th next tab.
 135         </p>
 136     </description>
 137 </item>
 138
 139 <item>
 140     <tags><![CDATA[<C-PageUp> <C-S-Tab> <C-p> gT]]></tags>
 141     <strut/>
 142     <spec><oa>count</oa>gT</spec>
 143     <description>
 144         <p>
 145             Go to the previous tab. Cycles to the last tab when the first one is selected.
 146             If <oa>count</oa> is specified, go to the <oa>count</oa>th previous tab.
 147         </p>
 148     </description>
 149 </item>
 150
 151 <item>
 152     <tags>:tabn :tabnext</tags>
 153     <spec>:<oa>count</oa>tabn<oa>ext</oa> <oa>count</oa></spec>
 154     <tags>:tn :tnext</tags>
 155     <spec>:<oa>count</oa>tn<oa>ext</oa> <oa>count</oa></spec>
 156     <tags>:bn :bnext</tags>
 157     <spec>:<oa>count</oa>bn<oa>ext</oa> <oa>count</oa></spec>
 158     <description>
 159         <p>
 160             Switch to the next or <oa>count</oa>th tab. Cycles to the first tab when
 161             the last one is selected and <oa>count</oa> is not specified.
 162         </p>
 163     </description>
 164 </item>
 165
 166 <item>
 167     <tags>:bN :bNext :bp :bprevious</tags>
 168     <spec>:<oa>count</oa>bp<oa>revious</oa> <oa>count</oa></spec>
 169     <spec>:<oa>count</oa>bN<oa>ext</oa> <oa>count</oa></spec>
 170     <tags>:tN :tNext :tabN :tabNext</tags>
 171     <spec>:<oa>count</oa>tabN<oa>ext</oa> <oa>count</oa></spec>
 172     <tags>:tp :tprevious :tabp :tabprevious</tags>
 173     <spec>:<oa>count</oa>tabp<oa>revious</oa> <oa>count</oa></spec>
 174     <spec>:<oa>count</oa>tp<oa>revious</oa> <oa>count</oa></spec>
 175     <description>
 176         <p>
 177             Switch to the previous tab or go <oa>count</oa> tabs back. Wraps around from the
 178             first tab to the last tab.
 179         </p>
 180     </description>
 181 </item>
 182
 183 <item>
 184     <tags><![CDATA[<C-6> <C-^>]]></tags>
 185     <spec><oa>count</oa>&lt;C-^></spec>
 186     <description>
 187         <p>
 188             Select the previously selected tab. This provides a quick method of toggling
 189             between two tabs. If <oa>count</oa> is specified, go to the <oa>count</oa>th tab.
 190         </p>
 191     </description>
 192 </item>
 193
 194 <item>
 195     <tags>b :b :buffer</tags>
 196     <spec>:<oa>count</oa>b<oa>uffer</oa><oa>!</oa> <oa>url|index</oa></spec>
 197     <spec>:<oa>count</oa>b<oa>uffer</oa><oa>!</oa> <a>match</a></spec>
 198     <spec><oa>count</oa>b</spec>
 199     <description>
 200         <p>
 201             Go to the specified buffer from the buffer list. Argument can be
 202             either the buffer index or the full URL opened in an existing
 203             buffer. If <oa>count</oa> is given, go to the <oa>count</oa>th
 204             buffer.
 205         </p>
 206
 207         <p>
 208             If argument is neither a full URL nor an index but uniquely identifies a
 209             buffer, by a partial match with the URL or title, it is selected.
 210             With <oa>!</oa> the next buffer matching the argument is selected,
 211             even if it cannot be identified uniquely. Use <k>b</k> as a
 212             shortcut to open this prompt.
 213         </p>
 214
 215         <p>If argument is <em>#</em>, the alternate buffer will be selected (see <k name="C-^"/>).</p>
 216
 217         <p>If no argument is given, the current buffer remains current.</p>
 218     </description>
 219 </item>
 220
 221 <item>
 222     <tags>g^ g0</tags>
 223     <spec>g0</spec>
 224     <spec>g^</spec>
 225
 226     <tags>:bf :bfirst :br :brewind</tags>
 227     <spec>:br<oa>ewind</oa></spec>
 228     <spec>:bf<oa>irst</oa></spec>
 229
 230     <tags>:tabfir :tabfirst :tabr :tabrewind</tags>
 231     <spec>:tabr<oa>ewind</oa></spec>
 232     <spec>:tabfir<oa>st</oa></spec>
 233     <description>
 234         <p>Switch to the first tab.</p>
 235     </description>
 236 </item>
 237
 238 <item>
 239     <tags>g$ :bl :blast :tabl :tablast</tags>
 240     <spec>:tabl<oa>ast</oa></spec>
 241     <spec>:bl<oa>ast</oa></spec>
 242     <spec>g$</spec>
 243     <description>
 244         <p>Switch to the last tab.</p>
 245     </description>
 246 </item>
 247
 248 <item>
 249     <tags>:tabde :tabdetach</tags>
 250     <strut/>
 251     <spec>:tabde<oa>tach</oa></spec>
 252     <description>
 253         <p>
 254             Detach the current tab, and open it in its own window. As each
 255             window must contain at least one buffer, it is not possible to detach
 256             the last buffer in a window.
 257         </p>
 258     </description>
 259 </item>
 260
 261 <item>
 262     <tags>:taba :tabattach</tags>
 263     <spec>:taba<oa>ttach</oa> <a>window-index</a> <oa>buffer-index</oa></spec>
 264     <description>
 265         <p>
 266             Attach the current tab to another window. <a>window-index</a> is
 267             an index into the list of open windows and <oa>buffer-index</oa>
 268             is the index at which to insert the tab in the other window's
 269             buffer list. If this is the last buffer in a window, the window
 270             will be closed.
 271         </p>
 272     </description>
 273 </item>
 274
 275 <h2 tag="reordering-tabs">Reordering tabs</h2>
 276
 277 <item>
 278     <tags>:tabm :tabmove</tags>
 279     <spec>:tabm<oa>ove</oa> <a>N</a></spec>
 280     <spec>:tabm<oa>ove</oa> <a>match</a></spec>
 281     <spec>:tabm<oa>ove</oa><oa>!</oa> <a>+N|-N</a></spec>
 282     <description>
 283         <p>
 284             Move the current tab to the position of tab <a>N</a>. When <a>N</a>
 285             is <em>$</em>, the current tab is made the last one. <a>N</a> can
 286             also be prefixed with <em>+</em> or <em>-</em> to indicate a
 287             relative movement. If <oa>!</oa> is specified the movement wraps
 288             around the start or end of the tab list.
 289         </p>
 290         <p>
 291             The tab index may also be selected by a general <a>match</a> string
 292             like <ex>:buffer</ex>.
 293         </p>
 294     </description>
 295 </item>
 296
 297 <h2 tag="closing-tabs">Closing tabs</h2>
 298
 299 <item>
 300     <tags>d</tags>
 301     <tags>:tabc :tabclose</tags>
 302     <tags>:bun :bunload :bw :bwipeout :bd :bdelete</tags>
 303     <spec>:<oa>count</oa>bd<oa>elete</oa><oa>!</oa> <oa>arg</oa></spec>
 304     <spec>:<oa>count</oa>bun<oa>load</oa><oa>!</oa> <oa>arg</oa></spec>
 305     <spec>:<oa>count</oa>bw<oa>ipeout</oa><oa>!</oa> <oa>arg</oa></spec>
 306     <spec>:<oa>count</oa>tabc<oa>lose</oa><oa>!</oa> <oa>arg</oa></spec>
 307     <spec><oa>count</oa>d</spec>
 308     <description>
 309         <p>
 310             Delete current buffer. If <oa>count</oa> is specified then <oa>count</oa> tabs are
 311             removed. Afterwards, the tab to the right of the deleted tabs is selected.
 312         </p>
 313
 314         <p>
 315             When used with <oa>arg</oa>, remove all tabs which contain <oa>arg</oa> in the
 316             currently opened hostname. With <oa>!</oa>, remove all tabs for which
 317             the currently opened page's URL or title contains <oa>arg</oa>.
 318         </p>
 319     </description>
 320 </item>
 321
 322 <item>
 323     <tags>D</tags>
 324     <strut/>
 325     <spec><oa>count</oa>D</spec>
 326     <description>
 327         <p>Like <k>d</k> but selects the tab to the left of the deleted tabs after deletion.</p>
 328     </description>
 329 </item>
 330
 331 <item>
 332     <tags>:tabo :tabonly</tags>
 333     <strut/>
 334     <spec>:tabo<oa>nly</oa></spec>
 335     <description>
 336         <p>Close all buffers other than the currently visible tab.</p>
 337     </description>
 338 </item>
 339
 340 <item>
 341     <tags>u :u :undo</tags>
 342     <spec>:<oa>count</oa>u<oa>ndo</oa> <oa>url</oa></spec>
 343     <spec><oa>count</oa>u</spec>
 344     <description>
 345         <p>
 346             Restore a closed tab. If a <oa>count</oa> is given, restore the
 347             <oa>count</oa>th closed tab. With <oa>url</oa>, restores most
 348             recently closed tab with a matching URL.
 349         </p>
 350     </description>
 351 </item>
 352
 353 <item>
 354     <tags>:undoa :undoall</tags>
 355     <spec>:undoa<oa>ll</oa></spec>
 356     <description short="true">
 357         <p>Restore all closed tabs in the closed tabs list.</p>
 358     </description>
 359 </item>
 360
 361 <h2 tag="looping-over-tabs">Looping over tabs</h2>
 362
 363 <item>
 364     <tags>:tabd :tabdo :bufd :bufdo</tags>
 365     <spec>:tabd<oa>o</oa> <a>cmd</a></spec>
 366     <description>
 367         <p>
 368             Execute <a>cmd</a> once in each buffer. Each buffer is focused, in
 369             turn, and <a>cmd</a> is executed therein. The last buffer remains
 370             focused after execution.
 371         </p>
 372
 373         <p>
 374             <a>cmd</a> should not alter the tab list state by adding, removing or reordering
 375             tabs.
 376         </p>
 377     </description>
 378 </item>
 379
 380 <h2 tag="app-tabs application-tabs pinned-tabs">Application Tabs</h2>
 381
 382 <item>
 383     <tags>:pin :pintab</tags>
 384     <spec>:<oa>count</oa>pin<oa>tab</oa><oa>!</oa> <oa>arg</oa></spec>
 385     <description>
 386         <p>
 387             Pin tab as an application tab. If <oa>!</oa> is given,
 388             the tab's pinned state is toggled. Arguments and count
 389             are the same as for <ex>:bdelete</ex> and <ex>:buffer</ex>.
 390         </p>
 391     </description>
 392 </item>
 393
 394 <item>
 395     <tags>:unpin :unpintab</tags>
 396     <spec>:<oa>count</oa>unpin<oa>tab</oa> <oa>arg</oa></spec>
 397     <description>
 398         <p>
 399             Unpin tab as an application tab. Arguments and count
 400             are the same as for <ex>:pintab</ex>.
 401         </p>
 402     </description>
 403 </item>
 404
 405
 406 </document>
 407
 408 <!-- vim:se sts=4 sw=4 et: -->