ttimer.1 - stopwatch - simple timer for console or x root window
(HTM) git clone git://src.adamsgaard.dk/stopwatch
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
ttimer.1 (1282B)
---
1 .Dd $Mdocdate$
2 .Dt TIMER 1
3 .Os
4 .Sh NAME
5 .Nm timer
6 .Nd reports elapsed time after launch
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl p Ar prefix
10 .Op Fl P Ar postfix
11 .Op Fl i Ar interval
12 .Op Fl x
13 .Ar HH:MM:SS
14 .Sh DESCRIPTION
15 The
16 .Nm
17 counts down from for the specified duration in HH:MM:SS format, and
18 prints the remaining time to standard output by default.
19 The time is written in the format "%S s" for remaining time of less
20 than one minute long, "%M:%SS" for durations less than one hour,
21 and "%H:%MM:%SS" for all longer durations.
22 .Pp
23 In default mode, the program notifies the terminal via a bell
24 character when the timer ends.
25 When writing to the X root window
26 .Fl ( x ) ,
27 the string "END" is displayed upon completion.
28 .Pp
29 The options are as follows:
30 .Bl -tag -width Ds
31 .It Fl p Ar prefix
32 Print the
33 .Ar prefix
34 string before the time stamp.
35 .It Fl P Ar postfix
36 Print the
37 .Ar postfix
38 string after the time stamp.
39 .It Fl i Ar interval
40 update the elapsed time with this interval in seconds.
41 .It Fl x
42 write the output to the X root window parameter, which
43 .Xr dwm 1
44 uses as status line.
45 .El
46 .Sh EXIT STATUS
47 .Nm
48 exits with 0 on success, and >0 if a a runtime error occurs.
49 .Sh SEE ALSO
50 .Xr dwm 1 ,
51 .Xr spoon 1 ,
52 .Xr stopwatch 1 ,
53 .Xr xsetroot 1
54 .Sh AUTHORS
55 .An Anders Damsgaard Aq Mt anders@adamsgaard.dk