\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"}{2002}
\set{"man::month"}{Feb}
\set{"man::day"}{4}
\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}}
      Frequency in Hertz, can be specified as a positive real number.

   \item{\defopt{-l}{i}{loudness}}
      Loudness, which is specified as an integer inbetween 0 and 100.

   \item{\defopt{-d}{f}{duration}}
      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}}
   }
      These are unary options specifying the style in which to buzz.

   \item{\defopt{-style}{str}{buzz style}}
      \genarg{str} should be one of \v{bumblebee}, \v{dragonfly},
      \v{mosquito}, or \v{disk}.

   \item{\defopt{--scan}{scan mode}}
      This will buzz 10 seconds for each tune specified.
      Refer also to the \optref{-sd}{\genopt{-sd} option}.

   \item{\defopt{-sd}{i}{scan duration}}
      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 \publref{foobar} for an in-depth analysis.
   A different point of view is presented in \publref{barfoo}.

\sec{seealso}{SEE ALSO}

\par
   The \sibref{bell}{bell(1) manual}.
\${html}{This reference is not going anywhere; it just demonstrates
a way of implementing references to other utilities. Troff can not link anyway,
so this warning is strictly html.}

\${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
   \aref{http://www.google.com/search?hl=en&amp;q=zoem+macro}{http://www.google.com/search?hl=en&q=zoem+macro} .
   \: zoem has no good provision for url encoding, alas.
   \: zoem also provides \httpref#1, which prints and links to a URL.
   \: in this case it would fail, because of the '&' character.

\par
   \publanch{foobar}
   Bugs Bunny. Foo Bar.
   A history of making, maintenance, repair, and disposal.

\par
   \publanch{barfoo}
   Donald Duck. The futile mistake, and how it changes my life every day.

\"man::postamble"

