ncurses 6.2 - patch 20200718
[ncurses.git] / 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.