test/gdc.6

   1 .\"***************************************************************************
   2 .\" Copyright 2020 Thomas E. Dickey                                          *
   3 .\" Copyright 1998-2006,2017 Free Software Foundation, Inc.                  *
   4 .\"                                                                          *
   5 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
   6 .\" copy of this software and associated documentation files (the            *
   7 .\" "Software"), to deal in the Software without restriction, including      *
   8 .\" without limitation the rights to use, copy, modify, merge, publish,      *
   9 .\" distribute, distribute with modifications, sublicense, and/or sell       *
  10 .\" copies of the Software, and to permit persons to whom the Software is    *
  11 .\" furnished to do so, subject to the following conditions:                 *
  12 .\"                                                                          *
  13 .\" The above copyright notice and this permission notice shall be included  *
  14 .\" in all copies or substantial portions of the Software.                   *
  15 .\"                                                                          *
  16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  18 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  19 .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  20 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  21 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  22 .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  23 .\"                                                                          *
  24 .\" Except as contained in this notice, the name(s) of the above copyright   *
  25 .\" holders shall not be used in advertising or otherwise to promote the     *
  26 .\" sale, use or other dealings in this Software without prior written       *
  27 .\" authorization.                                                           *
  28 .\"***************************************************************************
  29 .\"
  30 .\" $Id: gdc.6,v 1.5 2020/02/02 23:34:34 tom Exp $
  31 .TH GDC 6
  32 .SH NAME
  33 gdc \- grand digital clock (curses)
  34 .SH SYNOPSIS
  35 .B gdc \fP[\fIoptions\fP] [\fIn\fP]
  36 .SH DESCRIPTION
  37 .I Gdc
  38 runs a digital clock made of reverse-video blanks on a terminal screen.
  39 If the terminal supports color, the clock is drawn in red.
  40 You can make the clock stop, pause or resume by pressing a ``q'',
  41 ``s'' or space, respectively.
  42 .SH OPTIONS
  43 .TP
  44 .B \-d
  45 use terminal's default colors for the background.
  46 .TP
  47 .B \-n
  48 redirects input to /dev/null, making it ignore the stop/pause commands.
  49 You can still stop it by pressing the interrupt key.
  50 .TP
  51 .B \-s
  52 makes digits scroll as they change.
  53 When running on a fast display, the program breaks up the scrolling into
  54 subsecond repaints, making the operation appear smooth.
  55 .TP
  56 .B \-t \fIhh:mm:ss\fP
  57 specify starting time (default is ``now'').
  58 .PP
  59 With an optional numeric argument
  60 .I num
  61 it stops after
  62 .I num
  63 seconds.
  64 Normally it runs "forever" (counting down from 2 billion seconds).
  65 .SH AUTHOR
  66 Amos Shapir, modified for curses by John Lupien.
  67 .br
  68 Improvements for ncurses by Thomas Dickey.