\import{../pud/man.zmm}

\begin{pud::man}{

   {year}{2000}
   {month}{Feb}
   {day}{29}
   {name}{buzzz}
   {html_title}{What's the buzzz}
   {html_keywords}{buzzz, dragonfly, bumblebee}
   {author}{Stijn van Dongen}
   {section}{1}
   {tag}{1.00}
}

\${html}{\"pud::man::maketoc"}

\def{buzzz}{\bf{buzzz}}

            \: the NAME macro below makes the output apropos compatible under troff.
\sec{name}{NAME}
\NAME{buzzz}{go buzzz.}

            \: customized command for the synopsis section.
\def{fileopt#2}{\bf{\1} (\it{\2})}

\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}{
   {interitem}{1}
}

\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.}

\end{pud::man}