do -s processing, even if output not a tty
[unix-history] / usr / src / usr.bin / calendar / calendar.1
CommitLineData
68b42178 1.\" @(#)calendar.1 6.1 (Berkeley) %G%
0edeeecc 2.\"
68b42178 3.TH CALENDAR 1 ""
0edeeecc
KM
4.AT 3
5.SH NAME
6calendar \- reminder service
7.SH SYNOPSIS
8.B calendar
9[ \- ]
10.SH DESCRIPTION
11.I Calendar
12consults the file `calendar' in the current directory
13and prints out lines that contain today's or
14tomorrow's date anywhere in the line.
15Most reasonable month-day dates such as `Dec. 7,'
16`december 7,' `12/7,' etc., are recognized, but not
17`7 December' or `7/12'.
a1d95394
KM
18If you give the month as ``*''
19with a date, i.e. ``* 1'', that day in any month will do.
0edeeecc
KM
20On weekends `tomorrow' extends through Monday.
21.PP
22When
23an argument is present,
24.I calendar
25does its job for every user
26who has a file `calendar' in his login directory
27and sends him any positive results by
28.IR mail (1).
29Normally this is done daily in the wee hours under control of
30.IR cron (8).
a1d95394
KM
31.PP
32The file `calendar' is first run through the ``C'' preprocessor,
33.IR /lib/cpp ,
34to include any other calendar files
35specified with the usual ``#include'' syntax.
36Included calendars will usually be shared by all users,
37maintained and documented by the local administration.
0edeeecc
KM
38.SH FILES
39calendar
40.br
41/usr/lib/calendar to figure out today's and tomorrow's dates
42.br
43/etc/passwd
44.br
45/tmp/cal*
46.br
a1d95394 47/lib/cpp, egrep, sed, mail as subprocesses
0edeeecc
KM
48.SH "SEE ALSO"
49at(1), cron(8), mail(1)
50.SH BUGS
0edeeecc
KM
51.I Calendar's
52extended idea of `tomorrow' doesn't account for
53holidays.