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