aboutsummaryrefslogtreecommitdiff
path: root/desktop/wmtimer/wmtimer.1
blob: ffb8eb7db4011968f7e461a3ad37127426d5879f (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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "WMTIMER" 1 "2021-09-09" "2.92" "SlackBuilds.org"
.SH NAME
wmtimer \- alarm clock dockapp for windowmaker
.\" RST source for wmtimer(1) man page. Convert with:
.
.\" rst2man.py wmtimer.rst > wmtimer.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
wmtimer \-[a|c|r] [\-b] [\-color \fI<color>\fP] [\-display \fI<display>\fP] [\-geometry \fI<geom>\fP] \-t \fI<hh:mm:ss>\fP \-e \fI<command>\fP
.SH DESCRIPTION
.sp
\fBwmtimer\fP is a dockable alarm clock for WindowMaker which can be run in
alarm, countdown timer, or chronograph mode. In alarm or timer mode,
you can either execute a command or sound the system bell when the time
is reached.
.sp
\fBwmtimer\fP can be configured either at startup time via the command
line, or by using the GTK interface by clicking on the main part of the
window (anywhere except the buttons).
.sp
To switch to the Chrono function simply click on the right arrow button to
start the chronograph.
.sp
You can pause the chronogaph by clicking on the center, rectangle button
and resume again by clicking the right arrow button.
.sp
You can reset the timer by clicking on the left arrow button.
.sp
Without any of the \fB\-a\fP, \fB\-c\fP, or \fB\-r\fP options, \fBwmtimer\fP
just shows the current time until it\(aqs clicked on.
.sp
Time entered via the command line must be in the form of hh:mm:ss. You
don\(aqt need to have 2 digits for each number but you must have at least
zeroes as placeholders for hours, minutes and seconds.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-a
Alarm mode. \fBwmtimer\fP will beep or exec a command at the specified time.
.TP
.B  \-b
Beep. This uses the X11 "system bell", which may be disabled
via \fBxset(1)\fP (in which case you won\(aqt hear anything).
.TP
.B  \-c
Countdown timer mode. \fBwmtimer\fP will beep or exec a command when specified time counts down to 0.
.UNINDENT
.INDENT 0.0
.TP
.B \-color \fIcolor\fP
Set text color; as a color name (e.g. \fBgreen\fP), or hex digits: \fIrgb:RR/GG/BB\fP or \fI#RRGGBB\fP\&.
.TP
.B \-display \fIdisplay\fP
X display to connect to (default: \fB:0\fP).
.TP
.B \-e \fIcommand\fP
Exec command. If the command has arguments, it must be quoted. If
any of the arguments have spaces, quote them again (e.g. use
double\-quotes around the whole command, and single\-quotes around
filenames with spaces).
.TP
.B \-geometry \fIgeom\fP
Window size and placement. Not usually needed.
.UNINDENT
.INDENT 0.0
.TP
.B  \-r
Start in chronograph (stopwatch) mode.
.UNINDENT
.INDENT 0.0
.TP
.B \-t \fI<hh:mm:ss>\fP
With \fB\-a\fP, sets the alarm time. With \fB\-c\fP, sets the initial time
to count down from. With \fB\-r\fP, sets the initial time to count \fIup\fP
from. Without this option, the default time is \fB00:00:00\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B  \-h
Show built\-in help.
.TP
.B  \-v
Print the version number and exit.
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/wmtimer\-2.92/COPYING for license information.
.SH AUTHORS
.sp
wmtimer was written by Josh King <\fI\%wmtimer@darkops.net\fP>.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
/usr/doc/wmtimer\-2.92/README
.\" Generated by docutils manpage writer.
.