test/gdc.6

   1 .\"***************************************************************************
   2 .\" Copyright 2020,2024 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.10 2024/06/22 21:31:03 tom Exp $
  31 .TH GDC 6 2024-06-15 ncurses-examples Games
  32 .ie \n(.g \{\
  33 .ds `` \(lq
  34 .ds '' \(rq
  35 .\}
  36 .el \{\
  37 .ie t .ds `` ``
  38 .el   .ds `` ""
  39 .ie t .ds '' ''
  40 .el   .ds '' ""
  41 .\}
  42 .SH NAME
  43 gdc \-
  44 grand digital clock using
  45 .I curses
  46 .SH SYNOPSIS
  47 .B gdc
  48 .RB [ \-dns ]
  49 .RB [ \-t
  50 .IB hh : mm : ss\c
  51 ]
  52 .RI [ count ]
  53 .SH DESCRIPTION
  54 .I gdc
  55 uses
  56 .I curses
  57 to display a clock on the terminal.
  58 It constructs the digits from reverse-video blank characters.
  59 If the terminal type supports color,
  60 the digits are drawn in red.
  61 Make the clock stop,
  62 pause,
  63 or resume by typing \*(``q\*('',
  64 \*(``s\*('',
  65 or space,
  66 respectively.
  67 .PP
  68 Given a numeric operand,
  69 the clock
  70 stops after
  71 .I count
  72 seconds.
  73 Normally,
  74 .I gdc
  75 runs \*(``forever\*(''
  76 (at least 2 billion seconds).
  77 .SH OPTIONS
  78 .TP
  79 .B \-d
  80 uses the terminal's default background color.
  81 .TP
  82 .B \-n
  83 reads input from
  84 .IR \%/dev/null ,
  85 making
  86 .I gdc
  87 ignore the stop and pause commands.
  88 You can still stop it with a terminal interrupt.
  89 .TP
  90 .B \-s
  91 scrolls the digits up as they change.
  92 When running on a fast display,
  93 the program breaks up the scrolling into sub-second redraws,
  94 making the operation appear smooth.
  95 .TP
  96 .BR \-t \ \c
  97 .IB hh : mm : ss
  98 uses the specified time instead of the current time.
  99 .SH AUTHORS
 100 Amos Shapir,
 101 John Lupien
 102 (modifications for
 103 .IR curses ),
 104 Thomas Dickey
 105 (improvements for
 106 .IR \%ncurses )