=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/calendar/calendar.1,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- src/usr.bin/calendar/calendar.1 1998/11/08 04:37:51 1.8 +++ src/usr.bin/calendar/calendar.1 1998/12/13 07:31:07 1.9 @@ -1,4 +1,4 @@ -.\" $OpenBSD: calendar.1,v 1.8 1998/11/08 04:37:51 pjanzen Exp $ +.\" $OpenBSD: calendar.1,v 1.9 1998/12/13 07:31:07 pjanzen Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,7 +40,7 @@ .Nm calendar .Nd reminder service .Sh SYNOPSIS -.Nm calendar +.Nm .Op Fl a .Op Fl A Ar num .Op Fl B Ar num @@ -48,7 +48,7 @@ .Op Fl f Ar calendarfile .Sh DESCRIPTION The -.Nm calendar +.Nm utility checks the current directory or the directory specified by the .Ev CALENDAR_DIR environment variable for a file named @@ -60,7 +60,9 @@ The following options are available: .Bl -tag -width Ds .It Fl a -Process the ``calendar'' files of all users and mail the results +Process the +.Dq calendar +files of all users and mail the results to them. This requires super-user privileges. .It Fl A Ar num @@ -76,7 +78,9 @@ .Pa calendarfile as the default calendar file. .It Fl t Ar [[[cc]yy][mm]]dd -Act like the specified value is ``today'' instead of using the current date. +Act like the specified value is +.Dq today +instead of using the current date. .El .Pp To handle calendars in your national code table you can specify @@ -99,13 +103,17 @@ Two numbers default to the month followed by the day. Lines with leading tabs default to the last entered date, allowing multiple line specifications for a single date. -``Easter'' (may be followed by a positive or negative integer) is -Easter for this year. -``Paskha'' (may be followed by a positive or negative integer) is +.Dq Easter +(may be followed by a positive or negative integer) is Easter for this year. +.Dq Paskha +(may be followed by a positive or negative integer) is Orthodox Easter for this year. -Weekdays may be followed by ``-4'' ... ``+5'' (aliases -last, first, second, third, fourth) for moving events like -``the last Monday in April''. +Weekdays may be followed by +.Dq -4 +.Li ... +.Dq +5 +(aliases last, first, second, third, fourth) for moving events like +.Dq the last Monday in April . .Pp By convention, dates followed by an asterisk .Pq Sq * @@ -117,7 +125,7 @@ If the first character in the line is a character, it is treated as the continuation of the previous description. .Pp -The ``calendar'' file is preprocessed by +The calendar file is preprocessed by .Xr cpp 1 , allowing the inclusion of shared files such as company holidays or meetings. @@ -159,13 +167,13 @@ file in current directory .It Pa ~/.calendar file in home directory (which -.Nm calendar +.Nm .Xr chdir 1 's into if it exists) .It Pa ~/.calendar/calendar file to use if no calendar file exists in the current directory .It Pa ~/.calendar/nomail -.Nm calendar +.Nm will not send mail if this file exists .It Pa calendar.birthday births and deaths of famous (and not-so-famous) people @@ -186,8 +194,7 @@ .It Pa calendar.music musical events, births, and deaths (strongly oriented toward rock n' roll) .It Pa calendar.usholiday -U.S. holidays (should be updated yearly by the local system administrator -so that roving holidays are set correctly for the current year) +U.S. holidays .It Pa calendar.german German calendar .It Pa calendar.russian @@ -211,19 +218,5 @@ command appeared in .At v7 . .Sh BUGS -.Nm calendar +.Nm doesn't handle Jewish holidays or moon phases. -.br -When used with the -.Fl A -and -.Fl B -flags, -.Nm calendar -will only print the first instance of periodic events. When using the -.Fl A -and -.Fl B -flags to cross a year boundary, -.Nm calendar -will use calculate the date of easter in the current year, not the next year.