summaryrefslogtreecommitdiffstats
path: root/docs/help/statusbar
blob: 8a4711b0488d8c84e088afedea9089ea5a71bdaa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
%9Syntax:%9

STATUSBAR ADD%||MODIFY [-disable | -nodisable] [-type window|root] [-placement top|bottom] [-position #] [-visible always|active|inactive] <statusbar>
STATUSBAR RESET %|<statusbar>
STATUSBAR ADDITEM%||MODIFYITEM [-before | -after <item>] [-priority #] [-alignment left|right] <item> <statusbar>
STATUSBAR REMOVEITEM %|<item> <statusbar>
STATUSBAR INFO %|<statusbar>

%9Parameters:%9

    ADD:          Adds a statusbar to the list of statusbars.
    MODIFY:       Modifies the configuration of a statusbar.
    RESET:        Restores the default statusbar configuration.
    ADDITEM:      Adds an item to the specified statusbar. It can be set to
                  appear before/after another item and left/right aligned
                  on the screen.
    MODIFYITEM:   Changes an item position inside a bar.
    REMOVEITEM:   Removes an item from the specified statusbar.
    INFO:         List the current details and items of the specified
                  statusbar.

    -disable:     Removes a statusbar from the list.
    -type:        Sets the type of statusbar, for each split window or only
                  once at the root (very top or bottom) of the screen.
    -placement:   Sets the placement of the statusbar, either at the top or
                  the bottom of the screen or split window.
    -position:    Sets the position of the statusbar. Represented as a
                  number, with smaller numbers implying a position further
                  to the top.
    -visible:     Sets the visibility of the statusbar. If set to always,
                  it is visible on all split windows, otherwise if set to
                  inactive or active then it is only visible on inactive or
                  active split windows, respectively.
    -before:      This item is added before the other item.
    -after:       This item is added after the other item.
    -priority:    When the statusbar items overflow, the item with the
                  lowest priority is removed or truncated first.
                  Priority can be negative, in which case it'll have to be
                  quoted (e.g. -priority "-1")
    -alignment:   Display the item on the right side.

    Where statusbar refers to the name of the statusbar; if no
    argument is given, or `LIST` is given, the entire list of
    statusbars along with a quick overview of their properties will be
    displayed.

%9Description:%9

    Allows adjustment of the attributes and items of a statusbar, as well
    as where it is located and whether or not it is currently visible.

%9Examples:%9

    /STATUSBAR
    /STATUSBAR INFO window
    /STATUSBAR REMOVEITEM time window
    /STATUSBAR ADDITEM time window
    /STATUSBAR RESET window
    /STATUSBAR MODIFY -disable topic
    /STATUSBAR MODIFY -nodisable topic

%9Remarks:%9

    Statusbar syntax was changed in Irssi 1.2. The old syntax is still
    accepted for backward compatibility, but no longer documented.

%9See also:%9 WINDOW