xref: /freebsd/usr.bin/grdc/grdc.6 (revision 88cbbbb6070ce3c5aea7b8d511039d44fc1f1c47)
1*71ed1addSGavin Atkinson.Dd January 15, 2023
26ae1554aSColin Percival.Dt GRDC 6
36ae1554aSColin Percival.Os
46ae1554aSColin Percival.Sh NAME
56ae1554aSColin Percival.Nm grdc
66ae1554aSColin Percival.Nd grand digital clock (curses)
76ae1554aSColin Percival.Sh SYNOPSIS
86ae1554aSColin Percival.Nm
96ae1554aSColin Percival.Op Fl st
106ae1554aSColin Percival.Op Ar n
11*71ed1addSGavin Atkinson.Nm
12*71ed1addSGavin Atkinson.Fl c
13*71ed1addSGavin Atkinson.Ar n
146ae1554aSColin Percival.Sh DESCRIPTION
156ae1554aSColin Percival.Nm
166ae1554aSColin Percivalruns a digital clock made of reverse-video blanks on a curses
176ae1554aSColin Percivalcompatible VDU screen.
186ae1554aSColin PercivalWith an optional numeric argument
196ae1554aSColin Percival.Ar n
206ae1554aSColin Percivalit stops after
216ae1554aSColin Percival.Ar n
226ae1554aSColin Percivalseconds (default never).
23*71ed1addSGavin AtkinsonThe clock can act as a countdown timer with the
24*71ed1addSGavin Atkinson.Fl c
25*71ed1addSGavin Atkinsonflag,
26*71ed1addSGavin Atkinson.Ar n
27*71ed1addSGavin Atkinsonspecifies the number of seconds to time for.
286ae1554aSColin PercivalThe optional
296ae1554aSColin Percival.Fl s
306ae1554aSColin Percivalflag makes digits scroll as they change.
316ae1554aSColin PercivalThe optional
326ae1554aSColin Percival.Fl t
336ae1554aSColin Percivalflag tells grdc to output the time in a 12-hour format.
346ae1554aSColin PercivalIn this curses mode implementation,
356ae1554aSColin Percivalthe scrolling option has trouble keeping up.
36991360baSGordon Bergling.Sh ENVIRONMENT
37991360baSGordon Bergling.Bl -tag -width Ds
38991360baSGordon Bergling.It Ev TZ
39991360baSGordon BerglingThe time zone to use for displaying the time.
40991360baSGordon BerglingIt is normally specified as a pathname relative to
41991360baSGordon Bergling.Pa /usr/share/zoneinfo ,
42991360baSGordon Berglingthough see
43991360baSGordon Bergling.Xr tzset 3
44991360baSGordon Berglingfor more information.
45991360baSGordon BerglingIf this variable is not set, the time zone is determined based on
46991360baSGordon Bergling.Pa /etc/localtime .
47991360baSGordon Bergling.El
48*71ed1addSGavin Atkinson.Sh NOTES
49*71ed1addSGavin AtkinsonIn countdown timer mode, the specifying of
50*71ed1addSGavin Atkinson.Fl n
51*71ed1addSGavin Atkinson> 360000 seconds (100 hours) will lead to the counter displaying
52*71ed1addSGavin Atkinsonincorrect remaining time, however it will time correctly, and
53*71ed1addSGavin Atkinsondisplay correctly when the remaining time becomes less than
54*71ed1addSGavin Atkinson100 hours.
556ae1554aSColin Percival.Sh AUTHORS
566ae1554aSColin Percival.An -nosplit
576ae1554aSColin Percival.An Amos Shapir ,
586ae1554aSColin Percivalmodified for curses by
596ae1554aSColin Percival.An John Lupien .
60*71ed1addSGavin AtkinsonCountdown timer mode by
61*71ed1addSGavin Atkinson.An Gavin Atkinson .
62