shithub: bar

ref: 40035151954a2a870e07e5e28dc176c0de6eabf5
dir: bar/bar.man

View raw version
.TH BAR 1
.SH NAME
bar \- display a bar
.SH SYNOPSIS
.B bar
[
.I -b
]
[
.I -d dateformat
]
[
.I -p position
]
[
.I -s separator
]
.SH DESCRIPTION
.I bar
displays a small window with current battery charge, date and time.
Additional data may be displayed by writing lines of text to its
standard input.
.PP
.I Bar
Reacts to mouse clicks by writing the "clicked" portion of the text
(enclosed by the separator) to standard output.  This can be used to
perform additional actions by a custom script.
.PP
By default,
.I bar
is placed at the bottom right corner of the screen.  This can be
changed by speicifying option
.I -p
with first letters of the required placement:
.I l
for "left",
.I r
for "right",
.I t
for "top" and
.I b
for "bottom".  If neither left nor right is chosen, the window will be
placed in either top or bottom center.
.PP
.I Bar
keeps itself as a top window. To make it stay at the bottom, use
.I -b .
.PP
Separator can be changed with
.I -s
option.
.PP
Date and time format may be set using
.I -d
option, see
.I tmdate(2).
.SH SOURCE
https://git.sr.ht/~ft/bar
.SH BUGS
Impossible.