forked from xorg62/tty-clock
-
Notifications
You must be signed in to change notification settings - Fork 0
/
tty-stopwatch.1
131 lines (131 loc) · 3.23 KB
/
tty-stopwatch.1
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
131
.\" This manpage was written by Carla Valenti <[email protected]>
.\" and Christian Giessen <[email protected]> for tty-stopwatch.
.\" In details the command line options displayed by tty-stopwatch -h as
.\" well as the keyboard commands.
.TH "TTY-CLOCK" "1" "October 2013" "" "User Commands"
.SH "NAME"
.LP
tty\-stopwatch \- a terminal digital stopwatch
.SH "SYNOPSIS"
.LP
\fBtty\-stopwatch [\-iuvsScbtrahDBxn] [\-C [\fI0\-7\fB]] [\-f \fIformat\fB] [\-d \fIdelay\fB] [\-a \fInsdelay\fB] \fB[\-T \fItty\fB]\fR
.SH "DESCRIPTION"
.LP
\fItty\-stopwatch\fR displays a simple digital stopwatch on the terminal. Invoked without options
it will display the stopwatch on the upper left corner of the screen on the terminal it was
executed from.
.SH "COMMANDS"
.LP
\fItty\-stopwatch\fR accepts a number of runtime keyboard commands, upper and lower case characters are
treated identically.
.TP
K,J,H,L
vi\-style movement commands to set the position of the displayed stopwatch.
These commands have no effect when the \fBcentered\fR option is set.
.TP
[0\-7]
Select a different color for displaying the stopwatch.
.TP
B
Toggles between bold and normal colors.
.TP
X
Toggles displaying a box around the stopwatch. This option is disabled by default.
.TP
C
Toggle the stopwatch's position to \fBcentered\fR.
When set the movement commands are disabled.
.TP
R
Set the stopwatch to \fBrebound\fR along the edges of the terminal.
.TP
S
Display seconds.
.TP
T
Switch time output to the 12\-hour format.
.TP
Q
Quit.
.SH "OPTIONS"
.LP
.TP
\fB\-s\fR
Show seconds.
.TP
\fB\-S\fR
Screensaver mode. tty\-stopwatch terminates when any key is pressed.
.TP
\fB\-x\fR
Show box.
.TP
\fB\-c\fR
Set the stopwatch at the center of the terminal.
.TP
\fB\-C\fR \fI[0\-7]\fR
Set the stopwatch color.
.TP
\fB\-b\fR
Use bold colors.
.TP
\fB\-t\fR
Set the hour in 12h format.
.TP
\fB\-u\fR
Use UTC time.
.TP
\fB\-T\fR \fItty\fR
Display the stopwatch on the given \fItty\fR. \fItty\fR must be
a valid character device to which the user has rw access permissions.
(See \fBEXAMPLES\fR)
.TP
\fB\-r\fR
Do rebound the stopwatch.
.TP
\fB\-f\fR \fIformat\fR
Set the date format as described in \fBstrftime(3)\fR.
.TP
\fB\-n\fR
Do not quit the program when the Q key is pressed (or when any
key is pressed while in \fBScreensaver\fR mode). A signal must
be sent to \fItty\-stopwatch\fR in order to terminate its execution. (See \fBEXAMPLES\fR)
.TP
\fB\-v\fR
Show tty\-stopwatch version.
.TP
\fB\-i\fR
Show some info about tty\-stopwatch.
.TP
\fB\-h\fR
Show usage information.
.TP
\fB\-D\fR
Hide the date.
.TP
\fB\-B\fR
Enable blinking colon.
.TP
\fB\-d\fR \fIdelay\fR
Set the delay (in seconds) between two redraws of the stopwatch. Default 1s.
.TP
\fB\-a\fR \fInsdelay\fR
Additional delay (in nanoseconds) between two redraws of the stopwatch. Default 0ns.
.SH "EXAMPLES"
.LP
To invoke
.I tty\-stopwatch
in screensaver mode with the stopwatch display set to rebound and the update
delay set to 1/10th of a second (10 FPS):
.IP
$ tty\-stopwatch \-Sra 100000000 \-d 0
.LP
The following example arranges for \fItty\-stopwatch\fR to be displayed
indefinitely on one of the Virtual Terminals on a Linux system
at boot time using an
.B inittab(5)
entry:
.IP
# /etc/inittab:
.br
9:2345:respawn:/usr/bin/tty\-stopwatch \-c \-n \-T /dev/tty9
.LP