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
|
.TH "SAYTIME" 1 "14 Sep 2004"
.SH NAME
saytime \- audio time check
.SH SYNOPSIS
.B saytime
[
.B \-ch
]
[
.BI "\-d" " dir"
]
[
.BI "\-f" " fmt"
]
[
.BI "\-o" " dev"
]
[
.BI "\-t" " output\-type"
]
.br
.SH DESCRIPTION
.I saytime
speaks the current time through the computer's sound device.
.SH OPTIONS
.TP
.BI "\-v" " factor"
Increase volume level by factor. Directly passed on to sox.
.TP
.BI "\-r" " sec"
Repeat at the specified interval in background mode.
.TP
.B \-c
Output to stdout.
.TP
.BI "\-d" " dir"
Use sounds from alternate directory (default /usr/share/saytime).
.TP
.BI "\-f" " fmt"
Specify format of time message. (see
.SM
.B FORMAT STRING
below).
.TP
.B \-h
Display simple help.
.TP
.BI "\-o" " dev"
Output to alternate file. If \-t is not specified with \-o, \-t
defaults to ossdsp.
.TP
.BI "\-t" " output\-type"
Specify the output type (oss, alsa, etc.); this is passed directly to
sox. If neither \-t nor \-o is specified, saytime will pick a default
destination via sox \-d.
.SH FORMAT STRING
A format string can be specified to control the time message.
Valid format characters are:
.TP
%k
hour, 24-hour clock (00..23)
.TP
%l
hour, 12-hour clock (01..12)
.TP
%M
minutes
.TP
%P
Introductory phrase ('The time is')
.TP
%S
seconds
.TP
The default format string is %P%l%M%S.
.SH BUGS
Likely a few. It doesn't handle errors gracefully.
.SH CONTRIBUTORS
Jef Poskanzer (original author),
.PP
Patrick J. Edwards <pje120@mail.usask.ca>
.PP
Charles Briscoe-Smith <cpbs@debian.org>
.PP
David C Dawson <beagle7@pacificcoast.net> (the
.B \-v
and
.B \-r
options)
|
