freebsd-src/usr.bin/grdc/grdc.6
Warner Losh 88cbbbb607 Revert "grdc: Add copyright"
It turns out this wasn't in 4.4BSD. I had a false positive for gdc.c
(which is in 4.4BSD, but part of gated, not this). gdc.c comes from the
ncurses tests, so it shouldn't have this copyright. This version is
mostly Amos Shapir and John Lupien's code. It comes from ncurses test
directory. ncurses has made dozens of improvements to this file since
we imported it in 1997 (which pre-dates their online history), so it's
not clear if their new copyright applies (which doesn't mention Amos
or John) or if some other copyright applies. In any case, it wasn't
4.4BSD, so revert this.

This reverts commit 6ed7d0e3ac.

Sponsored by:		Netflix
2024-05-10 14:12:19 -06:00

62 lines
1.3 KiB
Groff

.Dd January 15, 2023
.Dt GRDC 6
.Os
.Sh NAME
.Nm grdc
.Nd grand digital clock (curses)
.Sh SYNOPSIS
.Nm
.Op Fl st
.Op Ar n
.Nm
.Fl c
.Ar n
.Sh DESCRIPTION
.Nm
runs a digital clock made of reverse-video blanks on a curses
compatible VDU screen.
With an optional numeric argument
.Ar n
it stops after
.Ar n
seconds (default never).
The clock can act as a countdown timer with the
.Fl c
flag,
.Ar n
specifies the number of seconds to time for.
The optional
.Fl s
flag makes digits scroll as they change.
The optional
.Fl t
flag tells grdc to output the time in a 12-hour format.
In this curses mode implementation,
the scrolling option has trouble keeping up.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev TZ
The time zone to use for displaying the time.
It is normally specified as a pathname relative to
.Pa /usr/share/zoneinfo ,
though see
.Xr tzset 3
for more information.
If this variable is not set, the time zone is determined based on
.Pa /etc/localtime .
.El
.Sh NOTES
In countdown timer mode, the specifying of
.Fl n
> 360000 seconds (100 hours) will lead to the counter displaying
incorrect remaining time, however it will time correctly, and
display correctly when the remaining time becomes less than
100 hours.
.Sh AUTHORS
.An -nosplit
.An Amos Shapir ,
modified for curses by
.An John Lupien .
Countdown timer mode by
.An Gavin Atkinson .