summaryrefslogtreecommitdiff
path: root/test/gdc.6
diff options
context:
space:
mode:
Diffstat (limited to 'test/gdc.6')
-rw-r--r--test/gdc.696
1 files changed, 67 insertions, 29 deletions
diff --git a/test/gdc.6 b/test/gdc.6
index bf90b26f8b25..700687e63694 100644
--- a/test/gdc.6
+++ b/test/gdc.6
@@ -1,5 +1,5 @@
.\"***************************************************************************
-.\" Copyright 2020 Thomas E. Dickey *
+.\" Copyright 2020,2024 Thomas E. Dickey *
.\" Copyright 1998-2006,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
@@ -27,42 +27,80 @@
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: gdc.6,v 1.6 2020/02/02 23:34:34 tom Exp $
-.TH GDC 6 2020-02-02 ncurses-examples Games
+.\" $Id: gdc.6,v 1.10 2024/06/22 21:31:03 tom Exp $
+.TH GDC 6 2024-06-15 ncurses-examples Games
+.ie \n(.g \{\
+.ds `` \(lq
+.ds '' \(rq
+.\}
+.el \{\
+.ie t .ds `` ``
+.el .ds `` ""
+.ie t .ds '' ''
+.el .ds '' ""
+.\}
.SH NAME
-gdc \- grand digital clock (curses)
+gdc \-
+grand digital clock using
+.I curses
.SH SYNOPSIS
-.B gdc \fP[\fIoptions\fP] [\fIn\fP]
+.B gdc
+.RB [ \-dns ]
+.RB [ \-t
+.IB hh : mm : ss\c
+]
+.RI [ count ]
.SH DESCRIPTION
-.I Gdc
-runs a digital clock made of reverse-video blanks on a terminal screen.
-If the terminal supports color, the clock is drawn in red.
-You can make the clock stop, pause or resume by pressing a ``q'',
-``s'' or space, respectively.
+.I gdc
+uses
+.I curses
+to display a clock on the terminal.
+It constructs the digits from reverse-video blank characters.
+If the terminal type supports color,
+the digits are drawn in red.
+Make the clock stop,
+pause,
+or resume by typing \*(``q\*('',
+\*(``s\*('',
+or space,
+respectively.
+.PP
+Given a numeric operand,
+the clock
+stops after
+.I count
+seconds.
+Normally,
+.I gdc
+runs \*(``forever\*(''
+(at least 2 billion seconds).
.SH OPTIONS
.TP
.B \-d
-use terminal's default colors for the background.
+uses the terminal's default background color.
.TP
.B \-n
-redirects input to /dev/null, making it ignore the stop/pause commands.
-You can still stop it by pressing the interrupt key.
+reads input from
+.IR \%/dev/null ,
+making
+.I gdc
+ignore the stop and pause commands.
+You can still stop it with a terminal interrupt.
.TP
.B \-s
-makes digits scroll as they change.
-When running on a fast display, the program breaks up the scrolling into
-subsecond repaints, making the operation appear smooth.
+scrolls the digits up as they change.
+When running on a fast display,
+the program breaks up the scrolling into sub-second redraws,
+making the operation appear smooth.
.TP
-.B \-t \fIhh:mm:ss\fP
-specify starting time (default is ``now'').
-.PP
-With an optional numeric argument
-.I num
-it stops after
-.I num
-seconds.
-Normally it runs "forever" (counting down from 2 billion seconds).
-.SH AUTHOR
-Amos Shapir, modified for curses by John Lupien.
-.br
-Improvements for ncurses by Thomas Dickey.
+.BR \-t \ \c
+.IB hh : mm : ss
+uses the specified time instead of the current time.
+.SH AUTHORS
+Amos Shapir,
+John Lupien
+(modifications for
+.IR curses ),
+Thomas Dickey
+(improvements for
+.IR \%ncurses )