sys/man/1/calendar

   1 .TH CALENDAR 1
   2 .SH NAME
   3 calendar \- print upcoming events
   4 .SH SYNOPSIS
   5 .B calendar
   6 [
   7 .B -dy
   8 ]
   9 [
  10 .B -p
  11 .I days
  12 ]
  13 [
  14 .I file ...
  15 ]
  16 .SH DESCRIPTION
  17 .I Calendar
  18 reads the named files, default
  19 .BR /usr/$user/lib/calendar ,
  20 and writes to standard output any lines
  21 containing today's or tomorrow's date.
  22 Examples of recognized date formats are
  23 "4/11",
  24 "April 11",
  25 "Apr 11",
  26 "11 April",
  27 and
  28 "11 Apr".
  29 A special form may be used to represent weekly and
  30 monthly events:
  31 "Every Tuesday"
  32 "The third Wednesday"
  33 All comparisons are case insensitive.
  34 .PP
  35 If the
  36 .B -y
  37 flag is given, an attempt is made to match on year too.  In this case,
  38 dates of the forms listed above will be accepted if they are followed
  39 by the current year (or last two digits thereof) or not a year —
  40 digits not followed by white space or non-digits.
  41 .PP
  42 If the
  43 .B -p
  44 flag is given, its argument is the number of days ahead to match
  45 dates.  This flag is not repeatable, and it performs no special
  46 processing at the end of the week.
  47 .PP
  48 The
  49 .B -d
  50 flag enables debugging output.
  51 .PP
  52 On Friday and Saturday, events through Monday are printed.
  53 .PP
  54 To have your calendar mailed to you every day, use
  55 .IR cron (8).
  56 .SH FILES
  57 .TF /usr/$user/lib/calendar
  58 .TP
  59 .B /usr/$user/lib/calendar
  60 personal calendar
  61 .SH SOURCE
  62 .B /sys/src/cmd/calendar.c