man/man1/calendar.1

   1 .TH CALENDAR 1
   2 .SH NAME
   3 calendar \- reminder service
   4 .SH SYNOPSIS
   5 \fBcalendar [\fB\-\fR] [\fB\-r\fR]\fR
   6 .br
   7 .de FL
   8 .TP
   9 \\fB\\$1\\fR
  10 \\$2
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  17 .SH OPTIONS
  18 .FL "\-" "Work for every user and send mail to him"
  19 .FL "\-r" "Restrict multiple execution on the same day"
  20 .SH EXAMPLES
  21 .EX "calendar" "Check \fIcalendar\fR file in current directory"
  22 .EX "calendar" "Normary used under the control of cron(8)"
  23 .EX "calendar \-r" " Normary used in /etc/rc file"
  24 .SH DESCRIPTION
  25 .PP
  26 Basically \fIcalendar\fR program consults the file \fIcalendar\fR in the
  27 current directory and display lines which contain today's or tomorrow's date.
  28 Month-day formats such
  29 as '12/25', 'Dec. 25', 'december 25', '*/25', '12/*', '*/*' are
  30 recognized.  The asterisk
  31 means 'all' days or 'all' months.  On weekends 'tomorrow' extends through
  32 next Monday without any consideration about holidays.
  33 To prevent ambiguity, the formats '25 Dec.' and '25/12' are not recognized.
  34 .PP
  35 When an argument \fB\-\fR is present, \fIcalendar\fR works for all users
  36 with a file \fIcalendar\fR in their login directories and sends them mail.
  37 Normally this is done daily under the control of \fIcron\fR.
  38 .PP
  39 The \fB\-r\fR option does its the same job as \fB\-\fR option, but touches
  40 the \fIcalendar\fR to prevents further access on the same day.
  41 Normally this is done in the \fI/etc/rc\fR file on a machine  which may be
  42 booted several times in one day.
  43 .SH "SEE ALSO"
  44 .BR cron (8).