[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.21 and 1.43

version 1.21, 2003/03/10 15:37:30 version 1.43, 2018/06/03 06:50:35
Line 11 
Line 11 
 .\" 2. Redistributions in binary form must reproduce the above copyright  .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the  .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.  .\"    documentation and/or other materials provided with the distribution.
 .\" 3. All advertising materials mentioning features or use of this software  .\" 3. Neither the name of the University nor the names of its contributors
 .\"    must display the following acknowledgement:  
 .\"     This product includes software developed by the University of  
 .\"     California, Berkeley and its contributors.  
 .\" 4. Neither the name of the University nor the names of its contributors  
 .\"    may be used to endorse or promote products derived from this software  .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.  .\"    without specific prior written permission.
 .\"  .\"
Line 33 
Line 29 
 .\"  .\"
 .\"     @(#)calendar.1  8.1 (Berkeley) 6/29/93  .\"     @(#)calendar.1  8.1 (Berkeley) 6/29/93
 .\"  .\"
 .Dd June 29, 1993  .Dd $Mdocdate$
 .Dt CALENDAR 1  .Dt CALENDAR 1
 .Os  .Os
 .Sh NAME  .Sh NAME
Line 41 
Line 37 
 .Nd reminder service  .Nd reminder service
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm calendar  .Nm calendar
 .Op Fl a  .Op Fl abw
 .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 f Ar calendarfile  .Op Fl f Ar calendarfile
 .Op Fl t Ar [[[cc]yy][mm]]dd  .Op Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd
 .Sh DESCRIPTION  .Sh DESCRIPTION
 The  The
 .Nm  .Nm
Line 60 
Line 55 
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
   .It Fl A Ar num
   Print lines from today and next
   .Ar num
   days (forward, future).
 .It Fl a  .It Fl a
 Process the  Process the
 .Dq calendar  .Dq calendar
 files of all users and mail the results  files of all users and mail the results
 to them.  to them.
 This requires superuser privileges.  This requires superuser privileges.
 .It Fl A Ar num  
 Print lines from today and next  
 .Ar num  
 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
 days (backward, past).  days (backward, past).
 .It Fl f Pa calendarfile  .It Fl b
   Enforce special date calculation mode for Cyrillic calendars.
   .It Fl f Ar calendarfile
 Use  Use
 .Pa calendarfile  .Ar calendarfile
 as the default calendar file.  as the default calendar file.
 .It Fl t Ar [[[cc]yy][mm]]dd  .It Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd
 Act like the specified value is  Act like the specified value is
 .Dq today  .Dq today
 instead of using the current date.  instead of using the current date.
   If yy is specified, but cc is not,
   a value for yy between 69 and 99 results in a cc value of 19.
   Otherwise, a cc value of 20 is used.
   .It Fl w
   Print day of the week name in front of each event.
 .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
Line 95 
Line 95 
 .Dq Paskha=<national_name>  .Dq Paskha=<national_name>
 (for Orthodox Easter) can be used.  (for Orthodox Easter) can be used.
 .Pp  .Pp
   The
   .Dq CALENDAR
   variable can be used to specify the style.
   Only
   .Sq Julian
   and
   .Sq Gregorian
   styles are currently supported.
   Use
   .Dq CALENDAR=
   to return to the default (Gregorian).
   .Pp
 To enforce special date calculation mode for Cyrillic calendars  To enforce special date calculation mode for Cyrillic calendars
 you should specify  you should specify
 .Dq LANG=<local_name>  .Dq LANG=<local_name>
 and  and
 .Dq BODUN=<bodun_prefix>  .Dq BODUN=<bodun_prefix>
 where <local_name> can be ru_RU.KOI8-R, uk_UA.KOI8-U or by_BY.KOI8-B.  where <local_name> can be ru_RU.UTF-8, uk_UA.UTF-8 or by_BY.UTF-8.
 .Pp  .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
Line 148 
Line 160 
 .Pq Li /* ... */  .Pq Li /* ... */
 are ignored.  are ignored.
 .Pp  .Pp
 Some possible calendar entries (<tab> characters are highlighted by a  Some possible calendar entries
 \fB\et\fR sequence):  (a \fB\et\fR sequence denotes a <tab> character):
 .Bd -unfilled -offset indent  .Bd -unfilled -offset indent
 LANG=C  LANG=C
 Easter=Ostern  Easter=Ostern
Line 161 
Line 173 
 Jun. 15\fB\et\fRJune 15.  Jun. 15\fB\et\fRJune 15.
 15 June\fB\et\fRJune 15.  15 June\fB\et\fRJune 15.
 Thursday\fB\et\fREvery Thursday.  Thursday\fB\et\fREvery Thursday.
 June\fB\et\fREvery June 1st.  June\fB\et\fREvery June 1st.
 15 *\fB\et\fR15th of every month.  15 *\fB\et\fR15th of every month.
   
 May Sun+2\fB\et\fRsecond Sunday in May (Muttertag)  May Sun+2\fB\et\fRsecond Sunday in May (Muttertag)
 04/SunLast\fB\et\fRlast Sunday in April,  04/SunLast\fB\et\fRlast Sunday in April,
 \fB\et\fRsummer time in Europe  \fB\et\fRsummer time in Europe
 Easter\fB\et\fREaster  Easter\fB\et\fREaster
 Ostern-2\fB\et\fRGood Friday (2 days before Easter)  Ostern-2\fB\et\fRGood Friday (2 days before Easter)
 Paskha\fB\et\fROrthodox Easter  Paskha\fB\et\fROrthodox Easter
 .Ed  .Ed
 .Sh FILES  .Sh FILES
 .Bl -tag -width ~/.calendar/calendar -compact  .Bl -tag -width ~/.calendar/calendar -compact
 .It Pa calendar  .It Pa calendar
 file in current directory  File in current directory.
 .It Pa ~/.calendar  .It Pa ~/.calendar
 directory in the user's home directory (which  Directory in the user's home directory (which
 .Nm  .Nm
 changes into, if it exists)  changes 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  .Nm
 will not send mail if this file exists  will not send mail if this file exists.
   .It Pa calendar.all
   International and national calendar files.
 .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.
   .It Pa calendar.canada
   Canadian holidays.
 .It Pa calendar.christian  .It Pa calendar.christian
 Christian holidays (should be updated yearly by the local system administrator  Christian holidays (should be updated yearly by the local system administrator
 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.croatian
   Croatian calendar.
   .It Pa calendar.discord
   Discordian calendar (all rites reversed).
 .It Pa calendar.fictional  .It Pa calendar.fictional
 Fantasy and Fiction dates (mostly LOTR)  Fantasy and fiction dates (mostly LOTR).
   .It Pa calendar.french
   French calendar.
   .It Pa calendar.german
   German calendar.
 .It Pa calendar.history  .It Pa calendar.history
 everything else, mostly U.S. historical events  Miscellaneous history.
 .It Pa calendar.holiday  .It Pa calendar.holiday
 other holidays (including the not-well-known, obscure, and  Other holidays (including the not-well-known, obscure, and
 .Em really  .Em really
 obscure)  obscure).
 .It Pa calendar.judaic  .It Pa calendar.judaic
 Jewish holidays (should be updated yearly by the local system administrator  Jewish holidays (should be updated yearly by the local system administrator
 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.nz
   New Zealand calendar.
 .It Pa calendar.openbsd  .It Pa calendar.openbsd
 .Ox  .Ox
 related events  related events.
 .It Pa calendar.pagan  .It Pa calendar.pagan
 Pagan holidays, celebrations and festivals  Pagan holidays, celebrations and festivals.
   .It Pa calendar.russian
   Russian calendar.
   .It Pa calendar.space
   Cosmic history.
   .It Pa calendar.uk
   UK calendar.
   .It Pa calendar.ushistory
   U.S. history.
 .It Pa calendar.usholiday  .It Pa calendar.usholiday
 U.S. holidays  U.S. holidays.
 .It Pa calendar.world  .It Pa calendar.world
 World wide calendar  World wide calendar.
 .It Pa calendar.croatian  
 Croatian calendar  
 .It Pa calendar.german  
 German calendar  
 .It Pa calendar.russian  
 Russian calendar  
 .El  .El
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr at 1 ,  .Xr at 1 ,
Line 226 
Line 254 
 .Xr cpp 1 ,  .Xr cpp 1 ,
 .Xr mail 1 ,  .Xr mail 1 ,
 .Xr cron 8  .Xr cron 8
 .Sh COMPATIBILITY  .Sh STANDARDS
 The  The
 .Nm  .Nm
 program previously selected lines which had the correct date anywhere  program previously selected lines which had the correct date anywhere
Line 240 
Line 268 
 .At v7 .  .At v7 .
 .Sh BUGS  .Sh BUGS
 .Nm  .Nm
 doesn't handle Jewish holidays or moon phases.  doesn't handle all Jewish holidays or moon phases.
Legend:
Removed from v.1.21  
changed lines
  Added in v.1.43