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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
\def{"man::synstyle"}{long}
\def{"man::defstyle"}{long}
\import{man.zmm}
\: customized command for the synopsis section.
\def{fileopt#2}{\bf{\1} (\it{\2})}
\set{"man::year"}{2000}
\set{"man::month"}{Feb}
\set{"man::day"}{29}
\set{"man::name"}{buzzz}
\set{"man::html-title"}{What's the buzzz}
\set{"man::author"}{Stijn van Dongen}
\set{"man::section"}{1}
\set{"man::tag"}{1.00}
\"man::preamble"
\${html}{\"man::maketoc"}
\def{buzzz}{\bf{buzzz}}
\sec{name}{NAME}
\NAME{buzzz}{go buzzz.}
\: the NAME macro makes the output apropos compatible under troff.
\sec{synopsis}{SYNOPSIS}
\par{
\buzzz
\synreqopt{-l}{i}{loudness}
\synreqopt{-d}{f}{duration}
\synoptopt{-f}{f}{frequency}
\synoptopt{--dragonfly}{dragon style}
\synoptopt{--bumblebee}{bumble style}
\synoptopt{--disk}{computer style}
\synoptopt{-style}{some style}
\synoptopt{--scan}{scan mode}
\synoptopt{-sd}{i}{scan duration}
\fileopt{<file.bzz|dir>}{tune source}}
\sec{description}{DESCRIPTION}
\par{
\buzzz buzzes. It can do so in different styles, at different base
frequencies, and at different volumes. See the \secref{options} section
for a description of all options.}
\par{
The \optref{-l}{\genopt{-l}{loudness}} and
\optref{-d}{\genopt{-d}{duration}} options
are both mandatory. The last argument given must be a file containing
the tune to buzz, or a directory containing such tune files.
The tune must be contained in an interval of at most
five tones. Non-conforming tunes may damage your soundcard.}
\sec{options}{OPTIONS}
\begin{itemize}
\item{\defopt{-f}{f}{frequency}}
\car{
Frequency in Hertz, can be specified as a positive real number.}
\item{\defopt{-l}{i}{loudness}}
\car{
Loudness, which is specified as an integer inbetween 0 and 100.}
\item{\defopt{-d}{f}{duration}}
\car{
Duration in hours, can be specified as a positive real.}
\intermezzo{
The following options are discussed as a group:}
\items{
{\defopt{--dragonfly}{dragon style}}
{\defopt{--bumblebee}{bumble style}}
{\defopt{--disk}{computer style}}
{\defopt{--mosquito}{sting style}}
}
\car{
These are unary options specifying the style in which to buzz.}
\item{\defopt{-style}{str}{buzz style}}
\car{
\genarg{str} should be one of \v{bumblebee}, \v{dragonfly},
\v{mosquito}, or \v{disk}.}
\item{\defopt{--scan}{scan mode}}
\car{
This will buzz 10 seconds for each tune specified.
Refer also to the \optref{-sd}{\genopt{-sd} option}.}
\item{\defopt{-sd}{i}{scan duration}}
\car{
Sets the scan time in (an integer number of) seconds. This affects the
\optref{--scan}{\genopt{--scan} option}.}
\end{itemize}
\sec{files}{FILES}
\par{
/etc/zoem/foriamzoem.bzz contains the zoem jingle.\|
/etc/zoem/zoem.ascii-art contains zoem related ascii art.
An excerpt is shown below.}
\verbatim{
.-----------------------------.
| |
| _ " _ |
| (\\"/) (_\\|/_) |
| (/|\\) (_/|\\_) |
| | | |
| () | |
| -----% |
| () |
| ejm|
.-----------------------------.}
\sec{environment}{ENVIRONMENT}
\par{
Currently, no environmental issues with \buzzz.}
\sec{diagnostics}{DIAGNOSTICS}
\par{
If the tune spans an interval larger than 5 tones, buzzz will
emit little beeps. If the interval exceeds an octave, buzzz
will fork and exec \bf{bell}.}
\sec{bugs}{BUGS}
\par{
Some do.}
\sec{author}{AUTHOR}
\par{
Bugs Bunny.}
\sec{history}{HISTORY}
\par{
repeats itself, especially from a buzzing point of view.
Refer to \refer{foobar} for an in-depth analysis.
A different point of view is presented in \refer{barfoo}.}
\sec{seealso}{SEE ALSO}
\par{The \sibref{bell}{bell(1) manual}.}
\${html}{\par{
On the www it is difficult to show a manual page as compiled for rendering in a
terminal, but one can view a manual page as compiled for rendering by a
postscript interpreter.
Lo and behold \httpref{buzzz.ps}.}}
\par{
\reference{foobar}
Bugs Bunny. Foo Bar.
A history of making, maintenance, repair, and disposal.}
\par{
\reference{barfoo}
Donald Duck. The futile mistake, and how it changes my life every day.}
\"man::postamble"
|
