tabbed

Simple tabbing application for X11.
git clone git://r-36.net/tabbed
Log | Files | Refs | README | LICENSE

tabbed.1 (4220B)


      1 .TH TABBED 1 tabbed\-VERSION
      2 .SH NAME
      3 tabbed \- generic tabbed interface
      4 .SH SYNOPSIS
      5 .B tabbed
      6 .RB [ \-B ]
      7 .RB [ \-b ]
      8 .RB [ \-c ]
      9 .RB [ \-d ]
     10 .RB [ \-e ]
     11 .RB [ \-E ]
     12 .RB [ \-k ]
     13 .RB [ \-M ]
     14 .RB [ \-m ]
     15 .RB [ \-s ]
     16 .RB [ \-v ]
     17 .RB [ \-g
     18 .IR geometry ]
     19 .RB [ \-n
     20 .IR name ]
     21 .RB [ \-p
     22 .RB [ s {+/-} ] \fIpos\fR ]
     23 .RB [ \-o
     24 .IR normbgcol ]
     25 .RB [ \-O
     26 .IR normfgcol ]
     27 .RB [ \-t
     28 .IR selbgcol ]
     29 .RB [ \-T
     30 .IR selfgcol ]
     31 .RB [ \-u
     32 .IR urgbgcol ]
     33 .RB [ \-U
     34 .IR urgfgcol ]
     35 .RB [ \-r
     36 .IR narg ]
     37 .RI [ "command ..." ]
     38 .SH DESCRIPTION
     39 .B tabbed
     40 is a simple tabbed container for applications which support XEmbed. Tabbed
     41 will then run the provided command with the xid of tabbed as appended
     42 argument. (See EXAMPLES.) The automatic spawning of the command can be
     43 disabled by providing the -s parameter. If no command is provided
     44 tabbed will just print its xid and run no command.
     45 .SH OPTIONS
     46 .TP
     47 .B \-B
     48 show the status bar.
     49 .TP
     50 .B \-b
     51 do not show the status bar.
     52 .TP
     53 .B \-c
     54 close tabbed when the last tab is closed. Mutually exclusive with -f.
     55 .TP
     56 .B \-d
     57 detaches tabbed from the terminal and prints its XID to stdout.
     58 .TP
     59 .B \-e
     60 open new tabs by default in foreground.
     61 .TP
     62 .B \-E
     63 open new tabs by default in background.
     64 .TP
     65 .B \-f
     66 fill up tabbed again by spawning the provided command, when the last tab is
     67 closed. Mutually exclusive with -c.
     68 .TP
     69 .BI \-g " geometry"
     70 defines the X11 geometry string, which will fixate the height and width of
     71 tabbed.
     72 The syntax is
     73 .RI [=][ width {xX} height ][{+-} xoffset {+-} yoffset ].
     74 See
     75 .BR XParseGeometry (3)
     76 for further details.
     77 .TP
     78 .B \-k
     79 close foreground tabbed client (instead of tabbed and all clients) when
     80 WM_DELETE_WINDOW is sent.
     81 .TP
     82 .B \-M
     83 show the status bar at the bottom.
     84 .TP
     85 .B \-b
     86 show the status bar at the top.
     87 .TP
     88 .BI \-n " name"
     89 will set the WM_CLASS attribute to
     90 .I name.
     91 .TP
     92 .BR \-p " [" s {+-}] \fIpos\fR
     93 will set the absolute or relative position of where to start a new tab. When
     94 .I pos
     95 is is given without 's' in front it is an absolute position. Then negative
     96 numbers will be the position from the last tab, where -1 is the last tab.
     97 If 's' is given, then
     98 .I pos
     99 is a relative position to the current selected tab. If this reaches the limits
    100 of the tabs; those limits then apply.
    101 .TP
    102 .BI \-r " narg"
    103 will replace the
    104 .I narg
    105 th argument in
    106 .I command
    107 with the window id, rather than appending it to the end.
    108 .TP
    109 .B \-s
    110 will disable automatic spawning of the command.
    111 .TP
    112 .BI \-o " normbgcol"
    113 defines the normal background color.
    114 .RI # RGB ,
    115 .RI # RRGGBB ,
    116 and X color names are supported.
    117 .TP
    118 .BI \-O " normfgcol"
    119 defines the normal foreground color.
    120 .TP
    121 .BI \-t " selbgcol"
    122 defines the selected background color.
    123 .TP
    124 .BI \-T " selfgbcol"
    125 defines the selected foreground color.
    126 .TP
    127 .BI \-u " urgbgcol"
    128 defines the urgent background color.
    129 .TP
    130 .BI \-U " urgfgbcol"
    131 defines the urgent foreground color.
    132 .TP
    133 .B \-v
    134 prints version information to stderr, then exits.
    135 .SH USAGE
    136 .TP
    137 .B Ctrl\-Shift\-Return
    138 open new tab
    139 .TP
    140 .B Ctrl\-Shift\-h
    141 previous tab
    142 .TP
    143 .B Ctrl\-Shift\-l
    144 next tab
    145 .TP
    146 .B Ctrl\-Shift\-j
    147 move selected tab one to the left
    148 .TP
    149 .B Ctrl\-Shift\-k
    150 move selected tab one to the right
    151 .TP
    152 .B Ctrl\-Shift\-e
    153 toggle behaviour of opening tabs in forground or background.
    154 .TP
    155 .B Ctrl\-Shift\-u
    156 toggle autofocus of urgent tabs
    157 .TP
    158 .B Ctrl\-Tab
    159 toggle between the selected and last selected tab
    160 .TP
    161 .B Ctrl\-b
    162 toggle the status bar
    163 .TP
    164 .B Ctrl\-m
    165 toggle the bar position between top and bottom
    166 .TP
    167 .B Ctrl\-t
    168 open dmenu to either create a new tab appending the entered string or select
    169 an already existing tab.
    170 .TP
    171 .B Ctrl\-q
    172 close tab
    173 .TP
    174 .B Ctrl\-u
    175 focus next urgent tab
    176 .TP
    177 .B Ctrl\-[0..9]
    178 jumps to nth tab
    179 .TP
    180 .B F11
    181 Toggle fullscreen mode.
    182 .SH EXAMPLES
    183 $ tabbed surf -e
    184 .TP
    185 $ tabbed urxvt -embed
    186 .TP
    187 $ tabbed xterm -into
    188 .TP
    189 $ $(tabbed -d >/tmp/tabbed.xid); urxvt -embed $(</tmp/tabbed.xid);
    190 .TP
    191 $ tabbed -r 2 st -w '' -e tmux
    192 .SH CUSTOMIZATION
    193 .B tabbed
    194 can be customized by creating a custom config.h and (re)compiling the source
    195 code. This keeps it fast, secure and simple.
    196 .SH AUTHORS
    197 See the LICENSE file for the authors.
    198 .SH LICENSE
    199 See the LICENSE file for the terms of redistribution.
    200 .SH SEE ALSO
    201 .BR st (1),
    202 .BR xembed (1)
    203 .SH BUGS
    204 Please report them.