[BACK]Return to calendar.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / calendar

Diff for /src/usr.bin/calendar/calendar.1 between version 1.8 and 1.18

version 1.8, 1998/11/08 04:37:51 version 1.18, 2002/03/20 22:59:56
Line 43 
Line 43 
 .Nm calendar  .Nm calendar
 .Op Fl a  .Op Fl a
 .Op Fl A Ar num  .Op Fl A Ar num
   .Op Fl b
 .Op Fl B Ar num  .Op Fl B Ar num
 .Op Fl t Ar [[[cc]yy][mm]]dd  
 .Op Fl f Ar calendarfile  .Op Fl f Ar calendarfile
   .Op Fl t Ar [[[cc]yy][mm]]dd
 .Sh DESCRIPTION  .Sh DESCRIPTION
 The  The
 .Nm calendar  .Nm
 utility checks the current directory or the directory specified by the  utility checks the current directory or the directory specified by the
 .Ev CALENDAR_DIR  .Ev CALENDAR_DIR
 environment variable for a file named  environment variable for a file named
Line 57 
Line 58 
 or tomorrow's.  or tomorrow's.
 On Fridays, events on Friday through Monday are displayed.  On Fridays, events on Friday through Monday are displayed.
 .Pp  .Pp
 The following options are available:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Fl a  .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.  to them.
 This requires super-user privileges.  This requires superuser privileges.
 .It Fl A Ar num  .It Fl A Ar num
 Print lines from today and next  Print lines from today and next
 .Ar num  .Ar num
 days (forward, future).  days (forward, future).
   .It Fl b
   Enforce special date calculation mode for KOI8 calendars.
 .It Fl B Ar num  .It Fl B Ar num
 Print lines from today and previous  Print lines from today and previous
 .Ar num  .Ar num
Line 76 
Line 81 
 .Pa calendarfile  .Pa calendarfile
 as the default calendar file.  as the default calendar file.
 .It Fl t Ar [[[cc]yy][mm]]dd  .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  .El
 .Pp  .Pp
 To handle calendars in your national code table you can specify  To handle calendars in your national code table you can specify
 .Dq LANG=<locale_name>  .Dq LANG=<locale_name>
 in the calendar file as early as possible. To handle national Easter  in the calendar file as early as possible.
 names in the calendars,  To handle national Easter names in the calendars,
 .Dq Easter=<national_name>  .Dq Easter=<national_name>
 (for Catholic Easter) or  (for Catholic Easter) or
 .Dq Paskha=<national_name>  .Dq Paskha=<national_name>
 (for Orthodox Easter) can be used.  (for Orthodox Easter) can be used.
 .Pp  .Pp
   To enforce special date calculation mode for Cyrillic calendars
   you should specify
   .Dq LANG=<local_name>
   and
   .Dq BODUN=<bodun_prefix>
   where <local_name> can be ru_RU.KOI8-R, uk_UA.KOI8-U or by_BY.KOI8-B.
   .Pp
 Other lines should begin with a month and day.  Other lines should begin with a month and day.
 They may be entered in almost any format, either numeric or as character  They may be entered in almost any format, either numeric or as character
 strings.  strings.
Line 99 
Line 113 
 Two numbers default to the month followed by the day.  Two numbers default to the month followed by the day.
 Lines with leading tabs default to the last entered date, allowing  Lines with leading tabs default to the last entered date, allowing
 multiple line specifications for a single date.  multiple line specifications for a single date.
 ``Easter'' (may be followed by a positive or negative integer) is  .Dq Easter
 Easter for this year.  (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 Paskha
   (may be followed by a positive or negative integer) is
 Orthodox Easter for this year.  Orthodox Easter for this year.
 Weekdays may be followed by ``-4'' ... ``+5'' (aliases  Weekdays may be followed by
 last, first, second, third, fourth) for moving events like  .Dq -4
 ``the last Monday in April''.  .Li ...
   .Dq +5
   (aliases last, first, second, third, fourth) for moving events like
   .Dq the last Monday in April .
 .Pp  .Pp
 By convention, dates followed by an asterisk  By convention, dates followed by an asterisk
 .Pq Sq *  .Pq Sq *
Line 117 
Line 135 
 If the first character in the line is a <tab> character, it is treated as  If the first character in the line is a <tab> character, it is treated as
 the continuation of the previous description.  the continuation of the previous description.
 .Pp  .Pp
 The ``calendar'' file is preprocessed by  The calendar file is preprocessed by
 .Xr cpp 1 ,  .Xr cpp 1 ,
 allowing the inclusion of shared files such as company holidays or  allowing the inclusion of shared files such as company holidays or
 meetings.  meetings.
Line 159 
Line 177 
 file in current directory  file in current directory
 .It Pa ~/.calendar  .It Pa ~/.calendar
 file in home directory (which  file in home directory (which
 .Nm calendar  .Nm
 .Xr chdir 1 's  .Xr chdir 1 's
 into if it exists)  into if it exists)
 .It Pa ~/.calendar/calendar  .It Pa ~/.calendar/calendar
 file to use if no calendar file exists in the current directory  file to use if no calendar file exists in the current directory
 .It Pa ~/.calendar/nomail  .It Pa ~/.calendar/nomail
 .Nm calendar  .Nm
 will not send mail if this file exists  will not send mail if this file exists
 .It Pa calendar.birthday  .It Pa calendar.birthday
 births and deaths of famous (and not-so-famous) people  births and deaths of famous (and not-so-famous) people
Line 174 
Line 192 
 so that roving holidays are set correctly for the current year)  so that roving holidays are set correctly for the current year)
 .It Pa calendar.computer  .It Pa calendar.computer
 days of special significance to computer people  days of special significance to computer people
   .It Pa calendar.fictional
   Fantasy and Fiction dates (mostly LOTR)
 .It Pa calendar.history  .It Pa calendar.history
 everything else, mostly U.S. historical events  everything else, mostly U.S. historical events
 .It Pa calendar.holiday  .It Pa calendar.holiday
Line 185 
Line 205 
 so that roving holidays are set correctly for the current year)  so that roving holidays are set correctly for the current year)
 .It Pa calendar.music  .It Pa calendar.music
 musical events, births, and deaths (strongly oriented toward rock n' roll)  musical events, births, and deaths (strongly oriented toward rock n' roll)
   .It Pa calendar.pagan
   Pagan holidays, celebrations and festivals
 .It Pa calendar.usholiday  .It Pa calendar.usholiday
 U.S. holidays (should be updated yearly by the local system administrator  U.S. holidays
 so that roving holidays are set correctly for the current year)  .It Pa calendar.world
   World wide calendar
   .It Pa calendar.croatian
   Croatian calendar
 .It Pa calendar.german  .It Pa calendar.german
 German calendar  German calendar
 .It Pa calendar.russian  .It Pa calendar.russian
Line 195 
Line 220 
 .El  .El
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr at 1 ,  .Xr at 1 ,
   .Xr cal 1 ,
 .Xr cpp 1 ,  .Xr cpp 1 ,
 .Xr mail 1 ,  .Xr mail 1 ,
 .Xr cron 8  .Xr cron 8
 .Sh COMPATIBILITY  .Sh COMPATIBILITY
 The  The
 .Nm calendar  .Nm
 program previously selected lines which had the correct date anywhere  program previously selected lines which had the correct date anywhere
 in the line.  in the line.
 This is no longer true:  the date is only recognized when it occurs  This is no longer true: the date is only recognized when it occurs
 at the beginning of a line.  at the beginning of a line.
 .Sh HISTORY  .Sh HISTORY
 A  A
Line 211 
Line 237 
 command appeared in  command appeared in
 .At v7 .  .At v7 .
 .Sh BUGS  .Sh BUGS
 .Nm calendar  .Nm
 doesn't handle Jewish holidays or moon phases.  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.  
Legend:
Removed from v.1.8  
changed lines
  Added in v.1.18