1.\" Copyright (c) 1989, 1990 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)calendar.1 6.10 (Berkeley) 08/31/90 7.\" 8.Dd 9.\" 10.Dt CALENDAR 1 11.Os BSD 4.4 12.Sh NAME 13.Nm calendar 14.Nd reminder service 15.Sh SYNOPSIS 16.Nm calendar 17.Op \-a 18.Sh DESCRIPTION 19.Nm Calendar 20checks the current directory for a file named named 21.Li calendar 22and displays lines that begin with either today's date 23or tomorrow's. 24On Fridays, events on Friday through Monday are displayed. 25.Pp 26The following options are available: 27.Tp Fl a 28Process the ``calendar'' files of all users and mail the results 29to them. 30This requires super-user privileges. 31.Tp 32.Pp 33A month and day should begin lines. 34They may be entered in almost any format, either numeric or as character 35strings. 36A single asterisk (``*'') matches every month. 37A day without a month matches that day of every week. 38A month without a day matches the first of that month. 39Two numbers default to the month followed by the day. 40Lines with leading tabs default to the last entered date, allowing 41multiple line specifications for a single date. 42By convention, dates followed by an asterisk are not fixed, i.e. change 43from year to year. 44.Pp 45The ``calendar'' file is preprocessed by 46.Xr cpp 1 , 47allowing the inclusion of shared files such as company holidays or 48meetings. 49If the shared file is not referenced by a full pathname, 50.Xr cpp 1 51searches in the current (or home) directory first, and then in the 52directory 53.Pa /usr/share/calendar . 54Empty lines and lines protected by the C commenting syntax (/* ... */) 55are ignored. 56.Pp 57Some possible calendar entries: 58.Pp 59.Ds I 60#include <calendar.usholiday> 61#include <calendar.birthday> 62 636/15 ... June 15 (if ambiguous, will default to month/day). 64Jun. 15 ... June 15. 6515 June ... June 15. 66Thursday ... Every Thursday. 67June ... Every June 1st. 6815 * ... 15th of every month. 69.De 70.Pp 71.Sh FILES 72The following default calendar files are provided: 73.Dw calendar.christian 74.Di L 75.Dp Pa calendar.birthday 76Births and deaths of famous (and not-so-famous) people. 77.Dp Pa calendar.christian 78Christian holidays. 79This calendar should be updated yearly by the local system administrator 80so that roving holidays are set correctly for the current year. 81.Dp Pa calendar.computer 82Days of special significance to computer people. 83.Dp Pa calendar.history 84Everything else, mostly U. S. historical events. 85.Dp Pa calendar.holiday 86Other holidays, including the not-well-known, obscure, and 87.Em really 88obscure. 89.Dp Pa calendar.judaic 90Jewish holidays. 91This calendar should be updated yearly by the local system administrator 92so that roving holidays are set correctly for the current year. 93.Dp Pa calendar.music 94Musical events, births, and deaths. 95Strongly oriented toward rock ' n' roll. 96.Dp Pa calendar.usholiday 97U.S. holidays. 98This calendar should be updated yearly by the local system administrator 99so that roving holidays are set correctly for the current year. 100.Dp 101.Sh SEE ALSO 102.Xr at 1 , 103.Xr cpp 1 , 104.Xr cron 8 105.Xr mail 1 , 106.Sh COMPATIBILITY 107The 108.Nm calendar 109program previously selected lines which had the correct date anywhere 110in the line. 111This is no longer true, the date is only recognized when it occurs 112first on the line. 113.Sh HISTORY 114A 115.Nm 116command appeared in Version 7 AT&T UNIX. 117The version of 118.Nm calendar 119released with this man page 120is unrelated. 121.Sh BUGS 122.Nm Calendar 123doesn't handle events that move around from year to year, i.e. 124``the last Monday in April''. 125