usr.bin/grdc/grdc.6

   1 .Dd January 15, 2023
   2 .Dt GRDC 6
   3 .Os
   4 .Sh NAME
   5 .Nm grdc
   6 .Nd grand digital clock (curses)
   7 .Sh SYNOPSIS
   8 .Nm
   9 .Op Fl st
  10 .Op Ar n
  11 .Nm
  12 .Fl c
  13 .Ar n
  14 .Sh DESCRIPTION
  15 .Nm
  16 runs a digital clock made of reverse-video blanks on a curses
  17 compatible VDU screen.
  18 With an optional numeric argument
  19 .Ar n
  20 it stops after
  21 .Ar n
  22 seconds (default never).
  23 The clock can act as a countdown timer with the
  24 .Fl c
  25 flag,
  26 .Ar n
  27 specifies the number of seconds to time for.
  28 The optional
  29 .Fl s
  30 flag makes digits scroll as they change.
  31 The optional
  32 .Fl t
  33 flag tells grdc to output the time in a 12-hour format.
  34 In this curses mode implementation,
  35 the scrolling option has trouble keeping up.
  36 .Sh ENVIRONMENT
  37 .Bl -tag -width Ds
  38 .It Ev TZ
  39 The time zone to use for displaying the time.
  40 It is normally specified as a pathname relative to
  41 .Pa /usr/share/zoneinfo ,
  42 though see
  43 .Xr tzset 3
  44 for more information.
  45 If this variable is not set, the time zone is determined based on
  46 .Pa /etc/localtime .
  47 .El
  48 .Sh NOTES
  49 In countdown timer mode, the specifying of
  50 .Fl n
  51 > 360000 seconds (100 hours) will lead to the counter displaying
  52 incorrect remaining time, however it will time correctly, and
  53 display correctly when the remaining time becomes less than
  54 100 hours.
  55 .Sh AUTHORS
  56 .An -nosplit
  57 .An Amos Shapir ,
  58 modified for curses by
  59 .An John Lupien .
  60 Countdown timer mode by
  61 .An Gavin Atkinson .