\: vim:syntax=tex
\: This file is maintained at http://git.mdcc.cx/draai
\: This is a manpage in zoem format.  See http://micans.org/zoem/, pud(7)
\: and /usr/share/doc/zoem/mac/buzzz.azm.gz

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

\begin{pud::man}{
  {name}{dr_watch}
  {html_title}{dr_watch}
  {section}{1}
  \man_share
}

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

\sec{name}{NAME}
\NAME{dr_watch}{execute a program periodically, showing output fullscreen}

\sec{synopsis}{SYNOPSIS}
  dr_watch command

\sec{description}{DESCRIPTION}

dr_watch behaves like watch(1): it runs command repeatedly, displaying its
output.  By defaults, it executes "sleep 2" before it refreshes the program's
output: it behaves as watch.  However, unlike watch, it supports refreshing the
screen when some external command, passed in the DR_SLEEP_CMD environment
variable, exits.

If DR_NICE_WATCH is set to "false", it tests whether watch(1) is available on
the system and runs it if found.

\sec{environment}{ENVIRONMENT}

dr_watch honors integer DR_SLEEP: number of seconds to wait between execution;
DR_SLEEP_CMD: e.g. 'sleep 5' or 'mpc idle'; and DR_NICE_WATCH: set this to
"false" if you prefer traditional watch over our reimplementation.

\sec{copyright and license}{COPYRIGHT AND LICENSE}

This manpage is copyright 2009, 2011, 2012, 2018 \"man::author".

Draai is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License, as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.  This program is distributed WITHOUT ANY WARRANTY.  You should have
received a copy of the GNU General Public License along with draai.  If not,
see \httpref{http://www.gnu.org/licenses/}.

\sec{author}{AUTHOR}

\"man::author"

\end{pud::man}